Tally

公式

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

Tally MCPで何ができますか?

  • 説明からフォームを作成 — アシスタントに新しいフォームの作成を依頼します。例えばシンプルな問い合わせフォームなどで、公開するまでプライベートな下書きとして保存されます。
  • 既存のフォームを編集 — URL を指定してフォームの変更を依頼します。フィールドの削除、captcha の追加、フィールドを任意項目にするなどができます。
  • フォームを公開 — 共有する準備ができたら、アシスタントに下書きフォームの公開を依頼します。
  • フォームの送信内容を取得 — フォームの送信内容を取得します。ステータスや日付範囲で絞り込むこともでき、質問ラベルと回答データが含まれます。
  • フォームの一覧表示と絞り込み — アクセス可能なワークスペース内のフォームを一覧表示し、名前、ステータス、新しさで絞り込めます。

ドキュメント

MCPサーバー

Model Context Protocol を通じて、AIアシスタントを使ってTallyフォームを作成したり、フォームや回答を一覧表示したりできます

[!WARNING]

Tally MCPサーバーは現在ベータ版であり、変更される可能性があります。

MCPとは?

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

サーバーURL

Tally MCPサーバーは以下で利用できます:

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での使用例

Tally MCP 使用例

ClaudeでOAuthを使用してTally MCPサーバーを設定する

Tally MCP OAuth 設定

このドキュメントは、開発者向けドキュメントプラットフォームであるMintlify上で構築およびホストされています。