Tally

官方

建立與編輯 Tally 表單,並分析提交內容

你可以用 Tally MCP 做什麼?

  • 從描述建立表單 — 請助理建立新表單,例如簡單的聯絡表單,該表單會儲存為私人草稿,直到你發佈為止。
  • 編輯現有表單 — 依 URL 請求變更表單,例如移除欄位、新增驗證碼,或將欄位設為選填。
  • 發佈表單 — 當你準備好分享時,請助理發佈草稿表單。
  • 擷取表單提交內容 — 擷取表單的提交內容,可選擇依狀態和日期範圍篩選,並包含問題標籤和回應資料。
  • 列出和篩選表單 — 列出你可存取的工作區中的所有表單,並依名稱、狀態或最近使用時間篩選。

文件

MCP 伺服器

透過模型上下文協定,使用 AI 助理建立 Tally 表單,並列出表單或提交內容

[!WARNING]

Tally MCP 伺服器目前處於 beta 階段,可能隨時變更。

什麼是 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,這是一個開發者文件平台。