ChipsAI MCP Server

ChipsAI MCP サーバー

ChipsBot 用の MCP（Model Context Protocol）サーバーです。Claude Code、Claude Desktop、または任意の MCP クライアントから、チャットボット、会話、ドキュメント、ボット間ルーティング、RAG 設定、AI モデルを管理できます。

要件

• Python 3.11 以降
• uv（推奨）または pip
• ChipsBot アカウント（登録）

クイックスタート

uv を使えば、インストールは不要です。

uv run --script server.py

または、手動でインストールします。

pip install "mcp[cli]" httpx
python server.py

設定

サーバーは認証に環境変数を使用します。推奨される方法は API キーです。API キーは ChipsBot ダッシュボードから生成できます。

変数	説明	デフォルト
CHIPSAI_API_KEY	ChipsAI API キー（推奨）	—
CHIPSAI_API_URL	API ベース URL	https://ai.chipsbuilder.com

レガシー：ユーザー名／パスワード認証

API キーをお持ちでない場合は、代わりにユーザー名とパスワードを使用できます。

変数	説明
CHIPSAI_USERNAME	ChipsAI ユーザー名
CHIPSAI_PASSWORD	ChipsAI パスワード

Claude Code

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "chipsai": {
      "command": "uvx",
      "args": ["chipsai-mcp"],
      "env": {
        "CHIPSAI_API_KEY": "chipsai_your_api_key_here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "chipsai": {
      "command": "uvx",
      "args": ["chipsai-mcp"],
      "env": {
        "CHIPSAI_API_KEY": "chipsai_your_api_key_here"
      }
    }
  }
}

利用可能なツール

チャットボット管理

ツール	説明
list_chatbots	認証済みユーザーのすべてのチャットボットを一覧表示します
get_chatbot	チャットボットの詳細（プロンプト、モデル、色など）を取得します
create_chatbot	新しいチャットボットを作成します（埋め込み用 script タグを返します）
update_chatbot	チャットボットの項目（名前、プロンプト、モデル、テーマ、色など）を更新します
delete_chatbot	チャットボットを論理削除（無効化）します
get_chatbot_config	公開ウィジェットの設定を取得します
get_chatbot_analytics	分析情報（メッセージ、セッション、日別統計、デバイス、国）を取得します

ドキュメント（RAG）

ツール	説明
upload_document	チャットボットのナレッジベースに PDF/DOC/DOCX をアップロードします（LlamaParse）

会話

ツール	説明
list_conversations	会話を一覧表示します。チャットボットで絞り込むこともできます
create_conversation	新しい会話を作成します
get_conversation	会話の詳細を取得します
update_conversation	会話のタイトルを更新します
delete_conversation	会話とすべてのメッセージを削除します
get_conversation_messages	会話のすべてのメッセージを取得します

ウィジェットの履歴

ツール	説明
list_conversation_history	ウィジェットの会話セッションを一覧表示します（ページネーション対応、チャットボットで絞り込み可能）
get_session_messages	ウィジェットの会話セッションからすべてのメッセージを取得します

チャット

ツール	説明
send_message	メッセージを送信して AI の応答を取得します（会話を自動作成します）

ボット間接続

ツール	説明
connect_bot	専門ボットをオーケストレーターボットに接続します（役割ベースのルーティング）
list_bot_connections	オーケストレーターボットに接続されたすべての専門ボットを一覧表示します
update_bot_connection	接続の役割、ラベル、説明、または有効状態を更新します
disconnect_bot	ボット間の接続を解除します

RAG 設定

ツール	説明
get_rag_config	RAG 設定（しきい値、チャンク設定、HyDE、L2、リランキング、システム指示）を取得します
update_rag_config	RAG 設定（しきい値、chunk_size、chunk_strategy、HyDE、L2、リランキングなど）を更新します

ユーザーとモデル

ツール	説明
get_user_plan	クレジット残高、無制限ステータス、使用統計を取得します
list_ai_models	プロバイダー別に、利用可能な AI モデルとクレジットコストを一覧表示します

RAG パイプライン

ChipsBot は、ボットごとに設定可能な完全な検索拡張生成（RAG）パイプラインをサポートしています。

• セマンティックルーティング（L1）： pgvector と Jina Embeddings v3 を使用し、コサイン類似度（HNSW インデックス）に基づいて、クエリを最適な専門ボットに振り分けます
• HyDE： 短いクエリや情報が少ないクエリの場合、Haiku で仮想的な回答を生成して再度埋め込み、検索精度を向上させます
• チャンク注入（L2）： 応答時に、プロンプト全体ではなく、関連性の高い上位 K 件のナレッジベースチャンクのみを注入します。トークン使用量を削減し、品質を向上させます
• 再ランキング： コサイン検索の後に、オプションで Jina クロスエンコーダーの再ランキングモデル（jina-reranker-v2-base-multilingual）を適用します
• チャンク分割方式： char（固定サイズ）、paragraph（意味に基づく \n\n 分割）、sentence（.!? 分割）
• ドキュメントのアップロード： PDF/DOC/DOCX は LlamaParse で解析し、抽出したテキストをナレッジベースとして保存します

get_rag_config / update_rag_config を使用して、すべてのパラメーターをボットごとに調整できます。

ボット間ルーティング

オーケストレーターボットは、役割や説明に基づいて質問を専門ボットに振り分けられます。オーケストレーターは自身の応答内の [ROUTE:uuid] タグを検出し、最近のチャット履歴をコンテキストとして渡して、該当する専門ボットに委任します。

connect_bot を使用して専門ボットをオーケストレーターに接続し、list_bot_connections でルーティングテーブルを確認できます。また、update_bot_connection で役割を調整したり、接続のオン／オフを切り替えたりできます。

クレジットシステム

ChipsAI はクレジット制の料金モデルを採用しています。

ティア	メッセージあたりのクレジット	モデル
無料	0	Llama 4 Scout、Llama 3.3 70B、Llama 3.1 8B（Groq）
エコノミー	0.5	Mistral Nemo、DeepSeek Chat
スタンダード	1.0	GPT-4o-mini、Gemini 2.5 Flash、Mistral Small、Claude Haiku 4.5
プレミアム	2.0	GPT-4o、Mistral Large、DeepSeek Reasoner
トップ	3.0	GPT-4.1、Claude Sonnet 4.6、Gemini 2.5 Pro

クレジットパッケージ：5 ユーロで 150 クレジット | 20 ユーロで 700 クレジット | 50 ユーロで 2000 クレジット。クレジットに有効期限はありません。独自の API キーを使用すると、どのモデルも無料で利用できます（クレジットは消費されません）。

使用例

設定後、Claude で自然言語を使用できます。

• 「自分のチャットボットを一覧表示して」
• 「Support Bot という名前のチャットボットを作成して」
• 「製品カタログの PDF を自分のチャットボットにアップロードして」
• 「自分のチャットボットにテストメッセージを送信して」
• 「過去 7 日間の分析を表示して」
• 「チャットボットのモデルを Claude Sonnet 4.6 に変更して」
• 「クレジット残高はいくら？」
• 「利用できる AI モデルは？」
• 「請求ボットをメインのオーケストレーターの専門ボットとして接続して」
• 「オーケストレーターに接続されている専門ボットをすべて一覧表示して」
• 「チャットボットの RAG 設定を表示して」
• 「RAG のしきい値を 0.5 に設定して、再ランキングを有効にして」
• 「top_k=5 で L2 チャンク注入を有効にして」

認証

API キー（推奨）： ダッシュボードで生成したキーを CHIPSAI_API_KEY に設定します。キーは Bearer トークンとして送信されるため、トークン管理は不要です。

JWT（旧方式）： ユーザー名とパスワードを使用する場合、JWT でトークンを取得し、透過的に更新します。

ライセンス

MIT