Typeform MCP 插件接入指南让 Cursor Agent 直接创建表单、分析回复并管理联系人【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins本篇技术指南围绕 Cursor 官方插件市场中的Typeform 插件展开它通过 Typeform 官方托管的远程 Model Context ProtocolMCP服务器把 Typeform 的表单能力接入 Cursor Agent。读完本文你将掌握该插件的安装流程、mcp.json远程服务器配置、OAuth 授权机制与作用域清单、EU 数据中心 URL 切换方法以及连接后如何用accounts-list_accounts做只读冒烟测试并了解其工具目录、传输协议与已知问题的边界。插件是什么一条连接 Cursor 与 Typeform 的官方 MCP 通道Typeform 插件位于仓库的 third_party/typeform 目录下是 Cursor 官方插件市场中的 Integrations集成类插件见 README.md 与 .cursor-plugin/marketplace.json 中的登记信息。它的定位非常聚焦本身不包含任何业务逻辑代码而是通过 Typeform 官方远程 MCP 服务器把 Typeform 的能力以标准 MCP 工具的形式暴露给 Agent。插件启用后Agent 可以在已登录的 Typeform 账户内完成以下操作创建与编辑表单form探索与洞察回复数据response insights管理联系人contact与工作区workspace。从仓库结构看该插件由五个文件组成README.md使用说明、mcp.jsonMCP 服务器定义、CHANGELOG.md版本记录、LICENSEMIT 协议与assets/logo.png官方标识。CHANGELOG.md记录了其 1.0.0 初始版本的核心动作——Added thetypeformMCP server pointing athttps://api.typeform.com/mcp并明确说明鉴权走 OAuth、无需配置 API Key 或 Client ID。安装插件市场与聊天命令两种入口安装 Typeform 插件有两种方式任选其一方式一通过 Cursor 设置面板打开Cursor Settings → Plugins设置 → 插件在插件市场中搜索Typeform点击Install安装随后按提示完成 Typeform 账户的登录授权。方式二通过聊天命令在 Cursor 的聊天框中直接运行/add-plugin typeform安装完成后Cursor 会在插件连接时弹出 Typeform 的登录授权提示完成 OAuth 授权后插件即可使用。该插件以typeform为 marketplace 名称登记在 .cursor-plugin/marketplace.json描述为 Build forms, analyze responses, and manage contacts。MCP 配置解析mcp.json与插件清单的对接插件自带的 MCP 服务器定义插件根目录下的 mcp.json 是它的核心配置文件内容如下{ mcpServers: { typeform: { type: http, url: https://api.typeform.com/mcp } } }这是一个标准的远程 MCP 服务器定义type字段为http表示采用 HTTP 传输而非本地 stdio 进程url指向 Typeform 官方托管的 MCP 端点https://api.typeform.com/mcp服务器名为typeform与插件名一致。从 schemas/plugin.schema.json 可以确认插件清单.cursor-plugin/plugin.json中的mcpServers字段被设计为路径、内联配置对象、或二者组成的数组三种形态之一见该文件的mcpServers定义schemas/plugin.schema.json。也就是说mcp.json这种独立文件形式正是清单允许的一种标准写法其结构完全符合 JSON Schema 的校验规则。如果想手动接入不使用插件即使不通过插件安装你也可以在 Cursor 或其他 MCP 客户端中手动配置同一套mcpServers结构把 Typeform 作为普通远程 MCP 服务器接入。上述 JSON 片段可直接复制使用。鉴权机制只认 OAuth拒绝 Personal Access TokenTypeform 插件的鉴权方式是OAuth这是本插件最值得注意的设计决策Cursor 在插件连接时弹出 Typeform 登录窗口用户完成授权后即可使用Typeform MCP 服务器会显式拒绝 Personal Access Token个人访问令牌因此 OAuth 是唯一可行的鉴权路径不存在填个 token 就完事的快捷方式插件无需配置任何 API Key 或 Client ID——授权信息完全由 OAuth 流程管理这一点也记录在 CHANGELOG.mdAuth uses OAuth — no API key or client ID to configure。OAuth 请求的权限作用域当用户授权连接时Typeform 会请求以下权限作用域scope作用域用途accounts:read读取账户信息forms:read读取表单forms:write创建/编辑表单contacts:read读取联系人contacts:write写入联系人insights:read读取回复洞察数据workspaces:read读取工作区权限边界工具调用以授权用户身份运行所有 MCP 工具调用都以授权该连接的 Typeform 用户的身份执行。也就是说Agent 能访问的数据范围等于该用户在 Typeform 中被授予的权限范围——不存在跨账户的超级权限。连接前必读EU 数据中心与服务器 URL 的选择插件默认指向Typeform 的默认数据中心https://api.typeform.com/mcp。如果你的 Typeform 账户托管在EU欧洲数据中心需要在配置中切换服务器 URL否则连接可能无法匹配账户所在区域账户所在数据中心服务器 URL默认非 EUhttps://api.typeform.com/mcpEU按账户位置二选一https://api.eu.typeform.com/mcp或https://api.typeform.eu/mcp切换方式是修改mcp.json中对应服务器的url字段。官方文档同时给出了两个 EU 端点具体使用哪一个取决于你的账户实际所在区域建议以 Typeform 账户设置中显示的区域为准。Agent 能力总览四个能力类别插件向 Agent 开放的能力分为四个类别类别Category能力CapabilitiesForms表单列出、读取、创建表单并检查表单能力form capabilitiesInsights洞察发现与分析回复数据Contacts联系人列出联系人并通过映射mapping导入表单回复Workspaces accounts工作区与账户列出工作区与账户工具清单以托管运行时为准由于 Typeform 的 MCP 服务器是官方托管的远程运行时工具的确切名称与参数 Schema 以该运行时的实际输出为唯一权威The hosted runtime is the source of truth for tool names and schemas。这意味着插件侧不硬编码工具列表工具目录可能随服务端更新而变化。连接后的冒烟测试连接完成后建议调用accounts-list_accounts作为只读冒烟测试该调用不会产生任何写入副作用它可以验证 OAuth 授权是否生效、通道是否连通、工具列表是否正确暴露若该调用能正常返回账户列表说明整条链路Cursor → MCP 服务器 → Typeform API已经打通。使用注意事项与已知边界以下几点属于使用该插件时必须了解的约束均以 Typeform 官方声明为准Beta 状态Typeform 官方将该 MCP 服务描述为generally available beta with limited capabilities通用可用 Beta能力有限因此工具目录随时可能调整Agent 不应依赖固定工具名。仅支持 Streamable HTTP唯一支持的传输方式是Streamable HTTP不存在 SSE 端点。配置时不需要也不能使用 SSE 协议。授权后可能暂时看不到工具如果授权完成后工具列表为空请刷新工具列表。Typeform 官方文档已将此列为已知问题known issue。无自托管选项与部分第三方插件不同Typeform MCP 只有官方托管端点不提供本地自托管服务器这一点与同目录下的 Jotform 插件 third_party/jotform/README.md 的Self-hosting is not offered约束一致后者也仅暴露托管端点。仓库层面的验证插件如何进入官方市场作为对照与背景你可以通过仓库中的三个文件验证该插件的合规性市场清单.cursor-plugin/marketplace.json 以name: typeform、source: third_party/typeform登记该插件清单 Schemaschemas/plugin.schema.json 定义了mcpServers等字段的合法形态mcp.json的文件结构与其兼容校验脚本scripts/validate-plugins.mjs 会逐个检查市场清单中的每个插件确认源码目录存在、plugin.json存在且通过 Schema 校验、市场名称与插件名称一致。Typeform 插件的mcp.json采用独立文件形式正对应plugin.json中mcpServers字段路径/内联对象/数组的弹性设计。总结一条零代码的 Typeform 集成路径Typeform 插件是 Cursor 官方插件市场中配置即集成的典型代表它用一份 mcp.json 指向官方托管端点用 OAuth 取代 API Key 管理用四个能力类别覆盖表单、洞察、联系人与工作区的日常操作。接入它只需三步安装插件 → 完成 OAuth 授权 → 用accounts-list_accounts验证连通。需要注意的边界是 EU 数据中心的 URL 切换、Streamable HTTP 单传输协议、Beta 期工具目录可变以及授权后需刷新工具列表的已知问题。该插件采用 MIT 协议发布见 LICENSE适合作为理解Cursor 插件 官方远程 MCP 服务器集成范式的入门样本。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考