Typeform MCP 插件接入指南：让 Cursor Agent 直接创建表单、分析回复并管理联系人
【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins
本篇技术指南围绕 Cursor 官方插件市场中的Typeform 插件展开，它通过 Typeform 官方托管的远程 Model Context Protocol（MCP）服务器，把 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.json（MCP 服务器定义）、CHANGELOG.md（版本记录）、LICENSE（MIT 协议）与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 Token
Typeform 插件的鉴权方式是OAuth，这是本插件最值得注意的设计决策：
- Cursor 在插件连接时弹出 Typeform 登录窗口，用户完成授权后即可使用；
- Typeform MCP 服务器会显式拒绝 Personal Access Token（个人访问令牌），因此 OAuth 是唯一可行的鉴权路径，不存在"填个 token 就完事"的快捷方式；
- 插件无需配置任何 API Key 或 Client ID——授权信息完全由 OAuth 流程管理（这一点也记录在 CHANGELOG.md："Auth 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 |
|---|---|
| 默认（非 EU） | https://api.typeform.com/mcp |
| EU（按账户位置二选一） | https://api.eu.typeform.com/mcp或https://api.typeform.eu/mcp |
切换方式是修改mcp.json中对应服务器的url字段。官方文档同时给出了两个 EU 端点，具体使用哪一个取决于你的账户实际所在区域，建议以 Typeform 账户设置中显示的区域为准。
Agent 能力总览：四个能力类别
插件向 Agent 开放的能力分为四个类别：
| 类别（Category） | 能力（Capabilities） |
|---|---|
| Forms（表单） | 列出、读取、创建表单，并检查表单能力（form capabilities） |
| Insights（洞察） | 发现与分析回复数据 |
| 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"登记该插件； - 清单 Schema：schemas/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），仅供参考
