Tally MCP Server

官方

创建和编辑Tally表单并分析提交内容

访问 tally.so

文档

MCP 服务器

通过模型上下文协议，使用 AI 助手构建 Tally 表单并列出表单或提交数据

Tally MCP 服务器目前处于测试阶段，可能会发生变化。

什么是 MCP？

模型上下文协议 (MCP) 允许您通过 Claude 等 AI 助手，使用自然语言构建 Tally 表单并检索表单或提交数据。

服务器 URL

Tally MCP 服务器位于：

https://api.tally.so/mcp

身份验证

Tally MCP 服务器支持两种身份验证方法：

选项 1：OAuth（推荐）

最简单的连接方式是通过 OAuth。许多 AI 助手支持 MCP 服务器的 OAuth 身份验证，让您只需点击几下即可连接，无需手动管理 API 密钥。

当您的 AI 助手提示进行 OAuth 身份验证时：

  1. 点击连接按钮或授权链接
  2. 登录您的 Tally 账户（如果尚未登录）
  3. 授权连接
  4. AI 助手将自动配置连接

选项 2：API 密钥

您也可以在 Authorization 标头中使用 API 密钥进行身份验证：

Authorization: Bearer tly-xxxx

详细了解如何获取您的 API 密钥。

配置

Claude Desktop

此方法适用于 Claude Desktop 和 claude.ai，并适用于所有支持连接器的 Claude 应用，包括 Claude Chat、Claude Code 和 Claude Cowork。

  1. 打开 Claude Desktop（或浏览器中的 claude.ai），从左侧边栏导航到 Customize > Connectors > Add custom connector。 Claude connectors
  2. 为连接器命名并提供 Tally MCP 服务器 URL。
https://api.tally.so/mcp
  1. 点击“Add”保存连接器。 Add Tally MCP connector
  2. 重启 Claude Desktop
  3. 首次使用 Tally MCP 服务器时，Claude 将打开 OAuth 流程以验证您的 Tally 账户。

Claude Code CLI

要将 Claude Code 连接到 Tally MCP 服务器，请在终端中运行以下命令：

claude mcp add tally --transport http https://api.tally.so/mcp

当您首次使用 Tally MCP 服务器时，Claude Code 将自动处理 OAuth 流程。您可以通过在 Claude Code 中运行 /mcp 命令来验证连接。

Cursor

  1. 打开 Cursor Settings > Tools & MCP
  2. 点击 New MCP Server
  3. 粘贴以下 JSON 以配置 Tally MCP 服务器：
{
  "mcpServers": {
    "tally": {
      "url": "https://api.tally.so/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

使用示例

配置完成后，您可以要求 AI 助手使用自然语言创建表单。以下是一些示例：

创建简单的联系表单

Create a simple contact form

AI 助手将根据其对典型联系表单应包含内容的理解，自动创建一个包含常用预期字段的联系表单。

更新联系表单

如果生成的表单不完全符合您的要求，您可以通过后续指令轻松修改它：

We don't need the Company field, remove the consent checkbox and maybe add a captcha

AI 助手应正确修改表单并保存。

创建包含特定字段的表单

或者，您可以明确指定所需的字段：

Create a contact form with these specific fields:
- Name (required)
- Email (required)
- Phone (optional)
- Message (required)
- Captcha (required)

AI 助手应创建一个包含指定字段的表单并保存。

更新现有表单

Update this form https://tally.so/r/a1B2c3
- Remove the phone number field
- Also add a captcha
- Make company field optional

AI 助手将使用 MCP 工具加载您的表单，进行所请求的更改，并保存更新后的版本。

获取表单提交数据

您可以获取任何表单的提交数据，并可选择按状态和日期范围进行筛选：

Show me all completed submissions for https://tally.so/r/a1B2c3 from January 2025

AI 助手将获取并显示您表单的匹配提交数据，包括问题标签和回复数据。

列出表单

您可以列出可访问工作区中的表单，并要求按名称、状态或最近更新进行筛选：

Show my 10 most recently updated published forms

AI 助手将调用 MCP 列表表单工具，并返回匹配的表单及其关键详细信息，如表单名称、URL、状态和最后更新日期。

与 Claude 一起使用的示例

使用 OAuth 与 Claude 配置 Tally MCP 服务器