toffu

Toffu MCP サーバー

Toffu は、エージェントが最初から最後まで実行できる、AI マーケティングプラットフォームです。広告アカウント （Google、Meta、LinkedIn）、分析、コンテンツ、キャンペーン、レポートに対応しています。このリポジトリでは、 Toffu のホスト型 MCP サーバーと、エージェントの接続方法について説明します。

• ホスト型エンドポイント：https://mcp.toffu.ai/mcp（ストリーミング可能な HTTP）
• 人間向けガイド：https://toffu.ai/agents
• 機械向けドキュメント：https://toffu.ai/llms.txt

人間を介さずに登録する

エージェントは 1 回の呼び出しでアカウントを作成し、キーを取得できます。メールアドレスは 不要です。

curl -X POST https://mcp.toffu.ai/agent/signup \
  -H 'content-type: application/json' \
  -d '{"company_name": "Acme"}'

レスポンスには api_key と company_id が含まれます。後から人間がアカウントを引き継げるようにするには、 実際の email を渡してください。

接続

キーをベアラートークンとして、クライアントに Toffu を MCP サーバーとして追加し、 ツールが読み込まれるようクライアントを再読み込みします。JSON-RPC を独自に実装しないでください。

Claude Code：

claude mcp add --transport http toffu https://mcp.toffu.ai/mcp \
  --header "Authorization: Bearer <api_key>"

汎用クライアント設定（Claude Desktop、Cursor など）：

{
  "mcpServers": {
    "toffu": {
      "type": "streamable-http",
      "url": "https://mcp.toffu.ai/mcp",
      "headers": { "Authorization": "Bearer <api_key>" }
    }
  }
}

Toffu は、同意フローを希望するクライアント向けに、Dynamic Client Registration を使用した OAuth 2.1 + PKCE にも対応しています。

CLI

ローカルエージェントやターミナルでは、npx toffu signup を実行してから、npx toffu ask "<task>" を実行します。cli/ を参照してください。

ツール

• send_message：自然言語で任意のマーケティングタスクを委任します
• query_campaign_performance：接続済みの広告プラットフォーム全体のパフォーマンスを確認します
• creative_report：Meta Ads のクリエイティブパフォーマンスを確認します
• propose_change / apply_change / undo_change：キャンペーンの変更を段階的に実施します
• get_account_context：オーナーのルールと接続済みアカウントを取得します（最初に呼び出してください）
• account_health：Meta の機会スコア、ピクセルの品質、カタログを確認します
• propose_ab_test：Meta の A/B テストを段階的に実施します
• get_task_result：時間のかかる send_message の回答を取得します

検出

• 機能ドキュメント：https://toffu.ai/.well-known/toffu.json
• llms.txt：https://toffu.ai/llms.txt

ライセンス

このリポジトリの内容は MIT ライセンスで提供されています。Toffu サービス自体は プロプライエタリです。https://toffu.ai/terms をご覧ください。