miibo-mcp

miiboチャットAPIをMCPツール化し、Claude CodeからAI社員（miiboエージェント）に直接話しかけるためのMCPサーバー。

構成

Claude Code ──(MCP/stdio)── server.js ──(HTTPS)── miibo チャットAPI
                                │                  https://api-mebo.dev/api
                                └─ employees.json（社員名→agent_id/api_key。git管理外）

• 本リポジトリは通信の器のみ。AI社員の原本（プロンプト・RAG素材）は別途管理する

• APIキー・agent_idは employees.json に置き、コミットしない

Related MCP server: claude-code-mcp

セットアップ

1. cp employees.json.example employees.json

2. miibo管理画面からAPIキーとagent_idを転記

3. Claude Codeに登録（済みなら不要）: claude mcp add miibo -s user -- node ~/project/miibo-mcp/server.js

ツール

キーは2系統: チャット用APIキー（エージェントに紐づく。default_api_key / 社員別 api_key）と Admin APIキー（admin_api_key + admin_uid。エージェント作成・一覧に使用）。

ステート（state）の注意点

miibo_chat の state はオブジェクトのまま送る必要がある。JSON文字列化して送るとチャットAPIは HTTP 400（空ボディ）を返し、応答が一切得られない。

渡した値をAIに読ませるには、エージェントのシステムプロンプト側に #{キー名} と書いて埋め込んでおくこと。埋め込みが無いと、値を渡しても応答には反映されない。

# プロンプト側
お客様のお名前: #{name}
会社名: #{company}

// miibo_chat の引数
{ "employee": "みお", "utterance": "こんにちは", "state": { "name": "井上", "company": "ENWA" } }

ライセンス

MIT License（LICENSE を参照）