Danielma Tic Fillout MCP Server

🚀 Fillout.io MCP サーバー

Fillout.io API の MCP サーバーで、フォーム管理、応答処理、分析を実現します。

🚀 クイックスタート

このセクションでは、Fillout.io MCP サーバーを使用するための基本的な手順を説明します。

✨ 主な機能

フォーム管理

• フォームの作成
• フォームの更新
• フォームの削除
• すべてのフォームの一覧表示

応答処理

• 応答の送信
• 特定の応答の取得
• 応答の削除
• 応答データのエクスポート

分析

• レポートの生成
• 統計情報の表示
• カスタム分析の設定

📦 インストール

トークン設定

1. Fillout.io API キーを取得します。

   • Fillout.io アカウントにログインします。
   • アカウント設定 → API と Webhook に移動します。
   • 「新しい API キーを作成」をクリックします。
   • 新しい API キーをコピーします。

2. API キーの情報：

   • 本番用キーは fo_live_ で始まります。
   • テスト用キーは fo_test_ で始まります。
   • テスト用キーはテストフォームにのみ使用できます。

3. 環境変数を設定します。

   FILLOUT_API_KEY=あなたのFillout.io APIキー
   

ツールの設定

ローカル開発設定

# 依存関係のインストール
npm install

# 開発モードで実行
npm run dev

# 本番用バージョンのビルド
npm run build

Docker 設定

# イメージのビルド
docker build -t mcp/fillout .

# コンテナの実行
docker run -e FILLOUT_API_KEY=あなたのキー mcp/fillout

💻 使用例

フォームの作成

const form = await client.createForm({
  name: "顧客フィードバック",
  description: "あなたの体験を共有してください",
  questions: [
    {
      type: "ShortAnswer",
      name: "あなたが最も好きな部分は何ですか？",
      required: true
    },
    {
      type: "MultipleChoice",
      name: "私たちをおすすめしますか？",
      required: true,
      choices: ["はい", "いいえ", "おそらく"]
    }
  ]
});

応答の送信

const response = await client.submitFormResponse(formId, {
  responses: [
    {
      questionId: "q1",
      value: "素晴らしい顧客サービス！"
    },
    {
      questionId: "q2",
      value: "はい"
    }
  ]
});

📚 ドキュメント

トラブルシューティング

以下は一般的な問題とその解決策です。

1. 無効な API キー

• 症状：API リクエストが「unauthorized」エラーを返します。
• 原因：使用しているキーが正しくないか、無効になっています。
• 解決策：
  • キーが正しいことを確認します。
  • キーの状態（有効/無効）を確認します。

2. レート制限を超過

• 症状：API リクエストが「too many requests」エラーを返します。
• 原因：短時間に多数のリクエストを送信しました。
• 解決策：
  • しばらく待ってから再度試してください。
  • API 使用プランをアップグレードします。

エラー処理

サーバーは問題の診断を支援するために詳細なエラーメッセージを提供します。

try {
  const forms = await client.listForms();
} catch (error) {
  if (error instanceof AuthenticationError) {
    // 無効な API キーの処理
  } else if (error instanceof FilloutError) {
    // API 固有のエラーの処理
  } else {
    // 予期しないエラーの処理
  }
}

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。