@toolpods/mcp-server

Toolpods の見積書・請求書を、Claude Desktop や Cursor などの MCP 対応クライアントから自然言語で操作するための MCP サーバー（および CLI）です。

内部的には Toolpods の API への薄いプロキシとして動作し、アカウント設定で発行した MCP トークンで認証します。

必要なもの

• Node.js 24 以上
• Toolpods の MCP トークン（アカウント設定 → MCPトークン から発行）

セットアップ（Claude Desktop の例）

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "toolpods": {
      "command": "npx",
      "args": ["-y", "--package", "@toolpods/mcp-server", "toolpods-mcp"],
      "env": {
        "TOOLPODS_API_BASE_URL": "https://api.toolpods.io",
        "TOOLPODS_AUTH_TOKEN": "tp_mcp_xxxxxxxxxxxx"
      }
    }
  }
}

TOOLPODS_AUTH_TOKEN を発行したトークンに置き換えて、クライアントを再起動してください。Cursor / Cline など他のクライアントでも、同じ command / args / env を各クライアントの MCP 設定に記述すれば動作します。

環境変数

| 変数 | 必須 | 説明 | | --- | --- | --- | | TOOLPODS_AUTH_TOKEN | ○（※） | アカウント設定で発行した MCP トークン（tp_mcp_ で始まる） | | TOOLPODS_API_BASE_URL | - | API のベース URL。デフォルトは http://localhost:3000。本番は https://api.toolpods.io | | TOOLPODS_COOKIE_HEADER | ○（※） | トークンの代わりに既存セッション Cookie を使う場合に指定 |

※ TOOLPODS_AUTH_TOKEN か TOOLPODS_COOKIE_HEADER のどちらかが必須です。

セキュリティ上の理由から、TOOLPODS_API_BASE_URL は HTTPS または localhost のみ許可されます。

できること

発行時に選択したスコープ（documents:read / documents:write）に応じて、見積書・請求書を操作できます。

• 見積書: 一覧・検索・取得、下書き作成 / 更新、ステータス変更、請求書への変換、履歴の閲覧 / 復元
• 請求書: 一覧・検索・取得、下書き作成 / 更新、ステータス変更、履歴の閲覧 / 復元
• 顧客: 検索

読み取り（documents:read）のみのトークンでは、作成・更新系の操作は実行できません。

CLI

MCP を介さず、同じ操作をコマンドラインから実行することもできます。

TOOLPODS_API_BASE_URL=https://api.toolpods.io \
TOOLPODS_AUTH_TOKEN=tp_mcp_xxxx \
npx --package @toolpods/mcp-server toolpods-cli estimates list --limit 10

引数なしで実行すると使用可能なサブコマンドが表示されます。

ライセンス

MIT