Tally

官方

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

你可以用 Tally MCP 做什么?

  • 根据描述创建表单 — 让助手构建一个新表单,例如一个简单的联系表单,在发布之前会保存为私有草稿。
  • 编辑现有表单 — 通过 URL 请求对表单进行更改,例如删除字段、添加验证码或将字段设为可选。
  • 发布表单 — 当你准备好分享时,让助手发布草稿表单。
  • 获取表单提交 — 检索表单的提交内容,可选择按状态和日期范围进行筛选,并包含问题标签和响应数据。
  • 列出和筛选表单 — 列出你可访问的工作区中的表单,并按名称、状态或最近时间进行筛选。

文档

MCP 服务器

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

[!WARNING]

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 的示例

Tally MCP 使用示例

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

Tally MCP OAuth 配置

本文档构建并托管在 Mintlify 上,这是一个开发者文档平台。