Genudo

Genudo MCP クライアント

Genudo は、あらゆるコミュニケーションチャネルやシーケンスベースのチャネル向けに AI エージェントを構築するためのプラットフォームです。パイプラインを認識し、連携機能と社内ナレッジへのアクセスを備えたエージェントを、単一のプラットフォーム、受信トレイ、分析ダッシュボードからすべて管理できます。この軽量ブリッジを使うと、Claude やその他の MCP クライアントを Genudo ワークスペースに接続し、チャットから直接エージェントを構築、実行、改善できます。

📖 どのインストール方法が適していますか？ CONNECT.md をご覧ください。Claude に Genudo を接続するすべての方法（プラグイン、コネクター、デスクトップ拡張機能、その他の MCP クライアント、リモート OAuth）を、価値に応じて整理し、コピーして使えるインストールコマンドとともに紹介しています。

概要

Genudo MCP クライアントは、Claude Code の stdio ベースの MCP 実装と Genudo の Streamable HTTP MCP サーバーの間をつなぎます。これにより、Claude Code との会話内で Genudo の強力な業務自動化ツールを直接活用できます。

機能

Genudo の業務自動化ツールを Claude Code から直接利用できます。サーバーは、次の 5 つの分野にわたる 29 個のツールを公開します。

• 📊 分析 — アカウント概要、メッセージング量の統計、AI のパフォーマンスとコスト（get_account_summary、get_messaging_stats、get_ai_performance）
• 🔎 検索 — パイプライン、ステージ、アクション、変数、連絡先、商談、メッセージ、ナレッジテーブルの一覧表示、ナレッジ検索、フォローアップ設定の読み取り、有効なビルドオプション（list_pipelines、list_pipeline_stages、list_actions、list_variables、list_contacts、list_opportunities、list_messages、list_knowledge_tables、search_knowledge_table、get_stage_followup、get_pipeline_options）
• 🚀 構築 — ガイド付きのステップごとのビルダーと、パイプライン、ステージ、変数、Webhook アクション、フォローアップシーケンス、ナレッジテーブルの直接作成（start_pipeline_journey、create_pipeline、create_stage、create_variable、create_action、create_followup、create_knowledge_table、upsert_knowledge_points）
• 🔧 更新 — 稼働中のパイプライン、ステージ、アクション、変数、商談（一括）、フォローアップを調整（update_pipeline、update_stage、update_action、update_variable、update_opportunities、update_followup）
• 🗑️ 削除 — 安定した ID でナレッジ行を削除（delete_knowledge_points）
• 🛍️ Shopify ナレッジエクスポーター — GraphQL で商品を動的に抽出し、HTML を除去し、アラビア語と英語のテキストを正規化して、UTF-8 BOM 付きの整形済み CSV と、アラビア語のタイトルを自動翻訳した整形済み Excel ナレッジベースを生成（shopify_export_catalog）

まず試す 3 つのワークフロー

1. AI を使った業務運用を監査する — Claude がアカウント、メッセージング、AI コストの統計を取得し、優先して修正すべき点を提示します。
2. エージェントのパフォーマンスを分析する — コストの高いエージェント、完了率の低いステージ、実行されていないアクションを見つけます。
3. パイプラインを作成または改善する — 例：「サマーキャンプ向けの Messenger 販売エージェントを作成してください。氏名、電話番号、支店、子どもの年齢を収集し、特別な配慮が必要な質問はエスカレーションしてください。」

ガイド付きの指示編集（組み込み）

このコネクターはツールを公開するだけでなく、エージェントが適切なエージェント指示を書く方法も、クライアント側だけでガイドします（追加のセットアップは不要です）。

• ガイドツール — get_instruction_guides（作成ルール + ペルソナ／グローバル設定 + ステージテンプレート + トークンを考慮した QA チェックリスト）と get_editing_playbook（安全な読み込み → 編集 → 差分確認 → 確認 → プッシュのワークフロー）。エージェントは必要に応じてこれらを取得します。
• プロンプト（任意の MCP クライアントで使えるスラッシュコマンド） — edit_instructions、build_pipeline、audit_pipeline。
• 安全性 — ライブエージェントを変更する前に、エージェントは list_pipelines／list_pipeline_stages から現在のテキストを読み込み、想定される影響とともに変更前後の差分を表示します。その後、あなたの確認を得てから update_pipeline／update_stage で変更を反映します。

クイックスタート

コマンドは 1 つだけです。クローンも手動設定も不要です。

claude mcp add --env GENUDO_TOKEN=YOUR_TOKEN --transport stdio genudo -- npx -y genudo-mcp-client

YOUR_TOKEN を Genudo トークンに置き換えてください（API Keys & Tokens → Create token で mcp:use スコープを選択してください。詳しくはトークンの取得をご覧ください）。Claude Code を再起動して、Genudo のツールを使い始めましょう！

前提条件

• Node.js 18.0.0 以降
• API アクセスが可能な Genudo アカウント
• Genudo トークン

インストール

推奨：コマンド 1 つ

claude mcp add --env GENUDO_TOKEN=YOUR_TOKEN --transport stdio genudo -- npx -y genudo-mcp-client

npx が公開済みのパッケージを取得して実行するため、クローンもローカルパスも不要です。API Keys & Tokens からトークンを取得して（下記参照）、Claude Code を再起動してください。

別の方法：ソースからインストール

ローカルでの開発やコントリビューションの場合：

git clone https://github.com/genudo-ai/genudo_mcp.git
cd genudo_mcp
npm install

その後、Claude Code を手動で設定してください（下記の「設定」セクションを参照）。

設定

ステップ 1：トークンを取得する

1. Genudo アカウントにログインします
2. サイドバーの Developer から API Keys & Tokens を開きます
3. Create token をクリックします
4. 名前を付けます（例：claude-mcp）
5. Scopes でリストをスクロールし、mcp:use（MCP サーバーへのアクセス — Streamable HTTP + JSON-RPC ツール呼び出し）にチェックを入れます
6. Expiry（有効期限）を選択します（30 日、90 日、1 年、または無期限）
7. Create token をクリックしてトークンをコピーします。トークンは一度しか表示されません。Genudo が保持するのはハッシュ化されたコピーのみです

ステップ 2：MCP クライアントを接続する

推奨 — Claude Code、コマンド 1 つ：

claude mcp add --env GENUDO_TOKEN=YOUR_TOKEN --transport stdio genudo -- npx -y genudo-mcp-client

Google Antigravity と Gemini CLI（agy）： antigravity/genudo/ から公式プラグインをインストールします：

# Global installation (recommended)
mkdir -p ~/.gemini/config/plugins/genudo && cp -R antigravity/genudo/* ~/.gemini/config/plugins/genudo/

または、プロジェクトごとに .agents/plugins/genudo/ に追加します。手順の詳細は antigravity/genudo/README.md をご覧ください。

その他のクライアント（Codex、Cursor、Windsurf、Claude Desktop）： 同じパッケージを使い、次のブロックをクライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "genudo": {
      "command": "npx",
      "args": ["-y", "genudo-mcp-client"],
      "env": {
        "GENUDO_TOKEN": "your_token_here"
      }
    }
  }
}

{
  "mcpServers": {
    "genudo": {
      "command": "node",
      "args": ["/absolute/path/to/genudo_mcp/index.js"],
      "env": { "GENUDO_TOKEN": "your_token_here" }
    }
  }
}

ステップ 3：Claude Code を再起動する

現在の Claude Code セッションを終了して、新しいセッションを開始します。

# Exit current session
exit

# Start new session
claude

使用方法

設定が完了すると、Claude Code は自動的に Genudo のツールを利用できるようになります。会話の中で使用できます。

例：

User: "Show me my account summary"
Claude: [Uses get_account_summary tool to fetch your data]

User: "Create a new sales pipeline using GPT-4"
Claude: [Uses get_pipeline_options and create_pipeline tools]

接続のテスト

ブリッジを手動でテストできます。

# Set your token
export GENUDO_TOKEN="your_token_here"

# Run the bridge
node index.js

# Send a test message (paste this and press Enter):
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

# You should receive a response with server info

トラブルシューティング

「GENUDO_TOKEN environment variable is required」

• Claude Code の設定でトークンが設定されていることを確認してください
• Genudo アカウントでトークンが有効であることを確認してください

「MCP handshake failed」／応答がない

• GENUDO_BASE_URL が正しいことを確認してください（デフォルトは https://api.genudo.ai）。ブリッジは <base>/mcp に POST します
• サーバーが稼働していて、アクセス可能であることを確認してください
• ファイアウォール／ネットワーク設定を確認してください

「HTTP 401: Unauthorized」

• トークンが無効か、有効期限が切れています
• Genudo アカウントの設定で新しいトークンを生成してください

自己署名証明書による接続の問題

• ブリッジはローカル開発用に自己署名証明書を受け入れるよう設定されています
• 本番環境では、適切な SSL 証明書を使用してください

環境変数

開発

プロジェクト構成

genudo-mcp-client/
├── index.js           # Main bridge script
├── package.json       # Node.js project config
├── .env.example       # Environment variables template
└── README.md          # This file

仕組み

1. ブリッジは <base>/mcp に対して MCP ハンドシェイクを実行します（Streamable HTTP）。
2. 標準入力から JSON-RPC リクエストを読み取ります（Claude Code から）。
3. 各リクエストを同じエンドポイントに HTTP POST で転送します。
4. レスポンスを標準出力経由で Claude Code に返します。

v2.5.0 以降、SSE の手順はありません。Streamable HTTP は、すべてのメッセージを POST として受け取る単一のエンドポイントです。ブリッジのローカルガイドツール、 プロンプト、レスポンスの簡素化が不要な場合は、ブリッジを省略して、クライアントを サーバーに直接接続できます。 claude mcp add --transport http genudo https://api.genudo.ai/mcp

Claude Code → (stdin) → Bridge → (HTTPS) → Genudo MCP Server
                ↑                              ↓
                └─────── (stdout) ←────────────┘

セキュリティに関する注意事項

• トークンをバージョン管理にコミットしないでください
• トークンは安全に保管してください（環境変数、シークレットマネージャーなど）
• トークンは定期的にローテーションしてください
• 本番環境では HTTPS を使用してください
• トークンのスコープは、必要最小限のアクセスに制限してください

プライバシーポリシー

このクライアントはローカルブリッジです。設定された Genudo エンドポイント以外に、 データを収集、保存、送信することはありません。

• 取り扱うデータ： GENUDO_TOKEN と、MCP クライアントが送信する JSON-RPC リクエストは、HTTPS 経由で、Authorization: Bearer ヘッダーにより、設定された Genudo サーバー（デフォルトは https://api.genudo.ai）にのみ送信されます。
• ローカルストレージ： ありません。ブリッジはログ、キャッシュ、テレメトリーを保持せず、 ディスクにデータを保存しません。トークンは MCP クライアント自身の設定に保持されます。
• 第三者： Genudo 以外の相手にデータを送信することはありません。
• データの保持とアカウントデータ： Genudo を通じてアクセスまたは作成するデータには、 Genudo のポリシーが適用されます。

ポリシー全文：プライバシーポリシー · 利用規約。お問い合わせ： [email protected]。

ライセンス

MIT

サポート

お困りですか？サポートをご利用ください。

• 📖 ドキュメント
• 💬 コミュニティフォーラム
• 🐛 問題を報告
• 📧 メールサポート

コントリビューション

コントリビューションを歓迎します！始め方については、CONTRIBUTING.mdをご覧ください。

概要：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

変更履歴

変更内容とバージョン履歴については、GitHub Releasesページをご覧ください。

関連プロジェクト

• Genudo - Genudo の自動化プラットフォーム本体
• Model Context Protocol - MCP の詳細
• Claude Code - Claude の AI コーディングアシスタント