Tally MCP Server

🚀 Tally MCP Server

Tally MCP Serverは、Tallyのフォーム管理を行うための包括的なModel Context Protocol (MCP)サーバーです。このサーバーは、Claude Desktopを通じて、フォーム、提出物、質問、ウェブフック、およびエンタープライズレベルの条件付きロジックを管理するための23の強力なツールを提供します。

作成者: @cathrynlavery | Claude Desktopを試す | Tally Formsを取得

✨ 主な機能

• Tallyフォームを完全に管理するための23の包括的なツール
• 重大なエラーを防止するエンタープライズレベルの条件付きロジック
• ブロックタイプのドキュメントとテンプレートを備えた高度なフォーム構築
• 一般的なユースケース（問い合わせ、調査、登録など）のフォームテンプレート
• 20種類以上の入力、レイアウト、およびロジックブロックをカバーする完全なブロックタイプリファレンス
• 調査を破壊するロジックエラーを防止する重要な検証ツール
• 複雑な条件付きオプションセットのための動的な質問管理
• 高度なフォーム編集機能を含む完全なAPIカバレッジ
• MCPプロトコルを介したシームレスなClaude Desktop統合
• 適切なJSONスキーマ検証による型安全
• エラーハンドリングとロギングを備えた本番環境対応

🚀 クイックスタート

前提条件

1. Node.js (v16以上)
2. Claude Desktop アプリケーション
3. APIアクセスを持つ**Tally** アカウント

1. インストール

git clone https://github.com/cathrynlavery/tally-mcp-server.git
cd tally-mcp-server
npm install
npm run build

2. Tally APIキーの取得

1. Tallyにサインアップします（無料アカウントでも可）。
2. https://tally.so/settings/apiにアクセスします。
3. 新しいAPIキーを作成します。
4. APIキー（tally_で始まる）をコピーします。

3. 環境変数の設定

# サンプル環境ファイルをコピー
cp .env.example .env

# .envを編集し、APIキーを追加
TALLY_API_KEY=tally_your_actual_api_key_here

4. Claude Desktopの設定

macOSのセットアップ

1. Claude Desktopの設定ファイルを開きます。

   # ディレクトリが存在しない場合は作成
   mkdir -p ~/Library/Application\ Support/Claude
   
   # 設定ファイルを開く（存在しない場合は作成）
   open ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. Tally MCPサーバーの設定を追加します。

   {
     "mcpServers": {
       "tally": {
         "command": "node",
         "args": ["/path/to/your/tally-mcp-server/start-server.js"],
         "env": {
           "TALLY_API_KEY": "tally_your_actual_api_key_here"
         }
       }
     }
   }
   

   重要: /path/to/your/tally-mcp-server/を実際のプロジェクトパスに置き換えてください！

Windowsのセットアップ

1. %APPDATA%\Claude\claude_desktop_config.jsonを開きます。
2. Windowsパスを使用して同じJSON構造を使用します。

   {
     "mcpServers": {
       "tally": {
         "command": "node",
         "args": ["C:\\path\\to\\your\\tally-mcp-server\\start-server.js"],
         "env": {
           "TALLY_API_KEY": "tally_your_actual_api_key_here"
         }
       }
     }
   }
   

Linuxのセットアップ

1. ~/.config/Claude/claude_desktop_config.jsonを開きます。
2. Linuxパスを使用して同じJSON構造を使用します。

5. セットアップのテスト

1. Claude Desktopを完全に再起動します（終了して再開）。
2. 新しい会話を開始します。
3. "Can you list my Tally forms?" を試します。

🤔 利用可能なツール（合計23個）

フォーム管理（5つのツール）

• get_tally_forms - すべてのフォームをリスト表示
• create_tally_form - 新しいフォームを作成
• get_tally_form - 特定のフォームの詳細を取得
• update_tally_form - 完全なAPIサポートと拡張されたブロック構造でフォームを更新
• delete_tally_form - フォームを削除

提出物管理（3つのツール）

• get_form_submissions - ページング付きでフォームの提出物をリスト表示
• get_form_submission - 特定の提出物の詳細を取得
• delete_form_submission - 提出物を削除

質問管理（1つのツール）

• get_form_questions - フォーム内のすべての質問をリスト表示

ウェブフック管理（4つのツール）

• get_tally_webhooks - フォームのウェブフックをリスト表示
• create_tally_webhook - 新しいウェブフックを作成
• update_tally_webhook - 既存のウェブフックを更新
• delete_tally_webhook - ウェブフックを削除

フォーム構築とテンプレート（2つのツール）

• get_tally_block_types - 利用可能なすべてのフォームブロックタイプの包括的なドキュメントを取得
• get_tally_form_templates - 一般的なユースケースのための事前構築されたフォームテンプレートを取得

高度な条件付きロジック（5つのツール）

• create_conditional_logic_block - 検証付きで適切に構造化された条件付きロジックブロックを作成
• validate_form_logic_flow - フォームの論理フローを分析して検証し、問題を特定
• get_conditional_logic_templates - 一般的なシナリオのための事前構築された条件付きロジックテンプレートを取得
• validate_multiple_choice_logic - 重要 - 複数選択の条件付きロジックを破壊する「equals」と「contains」のエラーを防止
• create_dynamic_question_sets - 重要 - 前の回答に基づいて変化する条件付きオプションセットを持つ質問を作成

フォーム編集ヘルパー（3つのツール）

• update_form_status - 迅速なステータス変更（BLANK、PUBLISHED、DRAFT）
• update_form_settings - 一般的なフォーム設定を更新
• configure_form_notifications - メール通知を設定

💬 Claudeでの使用例

設定が完了すると、Tallyフォームと自然に対話することができます。

• "Show me all my forms"
• "Create a new customer feedback form"
• "What types of form blocks are available in Tally?"
• "Give me a contact form template"
• "Build a survey with rating questions and multiple choice"
• "Create conditional logic that shows different questions based on user type"
• "Validate my multiple choice logic to prevent survey failures"
• "Create a dynamic question like Q5 in BestSelf survey with conditional option sets"
• "Check my conditional logic flow for dead ends"
• "Update my contact form to published status"
• "Get the latest 10 submissions for form xyz"
• "Set up email notifications for my survey"
• "Add a webhook to my form that sends to my API"
• "Delete submissions older than 30 days"
• "Change my form password to 'newpassword123'"
• "Show me templates for lead generation forms"

🔧 高度な設定

拡張されたフォーム構築機能

サーバーには、包括的なフォーム構築サポートが含まれています。

• ブロックタイプリファレンス：入力フィールド、レイアウト要素、およびロジックブロックを含む、すべての20種類以上のTallyブロックタイプの完全なドキュメント
• フォームテンプレート：問い合わせフォーム、調査、登録フォームなどの事前構築されたテンプレート
• プロフェッショナルな構造：ベストプラクティスに基づくすぐに使えるフォームレイアウト
• 高度な条件付きロジック：検証とエラー防止を備えたエンタープライズレベルの条件付きロジック
• 重大なエラー防止：調査を破壊するロジックエラーを自動検出
• 動的な質問管理：条件付きオプションセットを持つ複雑な質問を処理

重要な条件付きロジック機能

• 複数選択検証：複数選択の条件付きロジックを破壊する重大な「equals」と「contains」のエラーを防止
• 動的な質問セット：ユーザーの前の回答に基づいて異なるオプションを表示する、複雑な調査のQ5/Q6のような高度な質問を作成
• ロジックフロー分析：到達不能なブロック、循環ロジック、および欠落した参照をキャッチするための包括的な検証
• エンタープライズパターン：漸進的開示、分岐調査、資格判定フローなどのテンプレート

利用可能なブロックタイプ

• 入力ブロック：テキスト、メール、電話、日付、複数選択、チェックボックス、ドロップダウン、評価、ランキング、ファイルアップロード、署名、支払い
• レイアウトブロック：ステートメントテキスト、質問グループ、区切り線、画像、ビデオ、埋め込み
• ロジックブロック：条件付きジャンプ、計算機、非表示フィールド

カスタムフォーム更新

update_tally_formツールは、以下を含む包括的なフォーム編集をサポートしています。

• 基本プロパティ：名前、ステータス
• フォーム構造：詳細な検証を伴う完全なブロック/質問配列
• 高度な設定：通知、スタイリング、動作などの20以上のオプション
• セキュリティ：パスワード保護、提出制限
• 統合：リダイレクト、カスタムCSS、データ保持

環境変数

# 必須
TALLY_API_KEY=tally_your_api_key_here

# （開発用）オプション
NODE_ENV=development
DEBUG=true

代替設定方法

Claude Desktopの設定で直接APIキーを設定することもできます。

{
  "mcpServers": {
    "tally": {
      "command": "node",
      "args": ["/path/to/your/tally-mcp-server/start-server.js"],
      "env": {
        "TALLY_API_KEY": "tally_your_actual_api_key_here"
      }
    }
  }
}

🐛 トラブルシューティング

一般的な問題

1. "Command not found"エラー
   • Node.jsのインストールを確認します：node --version
   • Claude設定内の絶対パスを確認します
   • start-server.jsファイルが存在し、実行可能であることを確認します
2. "Authentication failed"エラー
   • .envまたはClaude設定内のAPIキーを再確認します
   • APIキーがtally_で始まることを確認します
   • TallyアカウントがAPIアクセスを持っていることを確認します
3. Claudeにツールが表示されない場合
   • Claude Desktopを完全に再起動します（終了して再開）
   • 設定ファイルのJSON構文を確認します（JSONバリデータを使用）
   • ファイルパスが相対ではなく絶対であることを確認します
   • Claude Desktopのログを確認してエラーを確認します
4. "Module not found"エラー
   • プロジェクトディレクトリでnpm installを実行します
   • npm run buildが正常に完了したことを確認します
   • build/ディレクトリが存在することを確認します

ローカルでのテスト

# サーバーがエラーなく起動することをテスト
npm start

# または、スタートスクリプトを直接使用
node start-server.js

# 簡単なAPI呼び出しでテスト（.envにAPIキーが必要）
curl -H "Authorization: Bearer $TALLY_API_KEY" https://api.tally.so/forms

デバッグモード

環境変数を設定してデバッグロギングを有効にします。

DEBUG=true NODE_ENV=development node start-server.js

ヘルプの取得

まだ問題が解決しない場合は、以下の手順を行ってください。

1. GitHub Issuesを確認します。
2. 以下の情報を含めて新しい問題を作成します。
   • オペレーティングシステム
   • Node.jsのバージョン (node --version)
   • エラーメッセージ
   • 設定内容（APIキーは除く）

📚 APIリファレンス

このMCPサーバーは、以下を含む完全なTally APIを実装しています。

• フォームAPI - 完全なCRUD操作
• 提出物API - フォームの回答を取得および管理
• 質問API - フォーム構造にアクセス
• ウェブフックAPI - リアルタイム統合

サポートされているTally APIエンドポイント

• GET /forms - フォームをリスト表示
• POST /forms - フォームを作成
• GET /forms/{id} - フォームを取得
• PATCH /forms/{id} - フォームを更新
• DELETE /forms/{id} - フォームを削除
• GET /forms/{id}/submissions - 提出物をリスト表示
• GET /forms/{id}/submissions/{id} - 提出物を取得
• DELETE /forms/{id}/submissions/{id} - 提出物を削除
• GET /forms/{id}/questions - 質問をリスト表示
• GET /forms/{id}/webhooks - ウェブフックをリスト表示
• POST /forms/{id}/webhooks - ウェブフックを作成
• PATCH /forms/{id}/webhooks/{id} - ウェブフックを更新
• DELETE /forms/{id}/webhooks/{id} - ウェブフックを削除

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

開発環境のセットアップ

# クローンしてインストール
git clone https://github.com/cathrynlavery/tally-mcp-server.git
cd tally-mcp-server
npm install

# 環境をセットアップ
cp .env.example .env
# .envにAPIキーを追加

# 自動再構築で開発
npm run dev

# 本番用にビルド
npm run build

# テストを実行（利用可能な場合）
npm test

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• Tally - このプロジェクトを可能にした素晴らしいフォームビルダー
• Claude Desktop - MCPプロトコルをサポートするAIアシスタント
• Anthropic - Model Context Protocolの仕様策定

❤️によって作成されました @cathrynlavery

Tallyを無料で試してみてください - 無制限のフォームと提出物が利用可能です！