Tally

官方

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

你可以用 Tally MCP 做什么?

  • 通过自然语言创建表单 — 让您的助手根据您指定的字段构建联系表单,它将生成一份私人草稿。
  • 编辑现有表单 — 通过分享表单的 URL,请求更改,例如移除字段或为表单添加验证码。
  • 发布或更新在线表单 — 请求发布草稿,或对已发布表单中的问题和内容进行更改,这些更改在您批准前保持未发布状态。
  • 获取表单提交 — 通过表单 URL 请求已完成的提交,可选择按状态或日期范围进行筛选。
  • 列出并筛选表单 — 请求查看跨工作区的表单,按名称、状态或最近更新进行筛选,并显示 URL 和最后更新日期等关键详情。

文档

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),从左侧边栏导航到 自定义 > 连接器 > 添加自定义连接器。 Claude connectors
  2. 为连接器命名并提供 Tally MCP 服务器 URL。
https://api.tally.so/mcp
  1. 点击“添加”以保存连接器。 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 设置 > 工具与 MCP
  2. 点击 新建 MCP 服务器
  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 服务器 本文档由 Mintlify 构建和托管,这是一个开发者文档平台。