Tally MCP Server

公式

Tallyフォームの作成・編集と送信データの分析

tally.so で表示

ドキュメント

MCP サーバー

Model Context Protocol を通じて AI アシスタントを利用し、Tally フォームの作成やフォーム・回答の一覧表示を行う

Tally MCP サーバーは現在ベータ版であり、予告なく変更される場合があります。

MCP とは？

Model Context Protocol (MCP) を使用すると、Claude のような AI アシスタントを介して自然言語で Tally フォームを作成したり、フォームや回答を取得したりできます。

サーバー URL

Tally MCP サーバーは以下の URL で利用できます。

https://api.tally.so/mcp

認証

Tally MCP サーバーは 2 つの認証方法をサポートしています。

オプション 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 Chat、Claude Code、Claude Cowork を含むコネクタをサポートするすべての Claude アプリに適用されます。

  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

Claude Code は、Tally MCP サーバーを初めて使用する際に 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 を使用した Tally MCP サーバーの設定 (Claude の場合)