CowAgent は Model Context Protocol (MCP) をサポートしており、コミュニティで提供されている数万種類の MCP Tool を Agent から直接呼び出せます。mcp.json を一度設定すれば、組み込みToolとまったく同じ形で LLM に公開され、自動的に選択・呼び出されます。
Web / デスクトップコンソール
Web コンソール とデスクトップクライアント の「機能」ページにある MCP Tool セクションから、mcp.json を手動で編集せずに MCP サーバーを追加・編集・無効化・削除できます。
フォームまたは JSON :フォーム入力のほか、JSON モードで標準の mcpServers 設定を貼り付けられます(複数サーバーを一括指定可)。例:{"mcpServers":{"fetch":{"command":"uvx","args":["mcp-server-fetch"]}}}。
接続テスト :サーバーが利用可能かを確認し、その Tool を一覧表示します。保存前にも自動で確認し、失敗した場合は設定を修正するか「このまま保存」を選択できます(保存後に認可が必要なサーバー向け)。
設定の保存先 :現在の Agent の mcp.json に、Claude Desktop / Cursor と同じ形式で書き込まれます。
即時反映 :変更は次のメッセージから反映され、再起動は不要です。
stdio、SSE、Streamable HTTP のいずれにも対応しています。無効化したサーバーはファイルに残りますが、起動されません。
設定ファイル
CowAgent は ~/cow/mcp.json を読み込みます。ファイルが存在しない場合は MCP Tool は読み込まれず、エラーにもなりません。
Docker デプロイの場合、公式の docker-compose.yml はホスト側の ./cow をコンテナ内の /home/agent/cow(コンテナユーザーの ~/cow)にマウント済みです。ホスト側の ./cow/ に mcp.json を置くだけで反映されます。
標準フォーマット
MCP コミュニティ標準に完全準拠しており、Claude Desktop / Cursor と同じです:
完全な例
fetch :汎用 Web ページ取得。ページ本文を返す。API Key 不要
github :GitHub のリポジトリ、Issue、PR などにアクセス。Personal Access Token が必要
Streamable HTTP + Bearer キー
固定の API Key で認証するリモート server は、type を明示し(リモート URL で省略すると sse として扱われます)、headers にキーを渡します:
ヘッダの値はそのまま送信されます。${API_KEY} は環境変数から展開されません
キーは mcp.json に平文で保存されるため、バージョン管理に含めないでください
Authorization を設定すると静的認証として扱われ、値が誤っていても下記の OAuth フローは実行されません
Agent に設定を任せる
CowAgent には read / write / edit Tool が組み込まれているため、MCP の設定をそのまま Agent に渡して、ファイルに書き込んでもらえます :
例:
Agent は次のように動作します:
既存の MCP 設定ファイルを読み込み、新しい server エントリをマージ(既存の項目は保持)
増分の MCP Server を自動でリロードし、次のメッセージから対応する Tool が利用可能に
mcp.json で設定したコマンドは Agent プロセスの権限で起動されるため、Agent による mcp.json の変更は フルアクセス のセッションでのみ許可されます。読み取り専用・ワークスペース書き込みのセッションでは拒否されるので、権限を切り替えるか、コンソールで設定してください。
Web 認可(OAuth)
一部のリモート MCP は OAuth の Web 認可が必要で、そのまま設定すると 401 が返ります。CowAgent は標準的な OAuth フローを内蔵しているため、token を手動で入力する必要はなく 、通常どおり設定するだけです。例:
server の初回ロードで 401 が返ると、認可が自動的に開始されます。ローカル実行では自動的にブラウザが開き 、サーバー環境では認可リンクがログに出力 されるので、ブラウザで開いてください。承認すると server はすぐにオンラインになり、token は期限切れ時に自動更新されるため、再認可は不要です。
Web サービスが必要 :認可コールバックは Web コンソール(既定ポート 9899)で受け取るため、Web channel が起動している必要があります。
認証情報の保存 :token は ~/.cow/mcp_oauth.json に永続化され、再起動後も再利用されます。
コールバック URL :既定は http://127.0.0.1:9899/mcp/oauth/callback。サーバーに配置し認可用ブラウザが別の端末にある場合は、config.json に mcp_oauth_redirect_base(例:http://あなたのIP:9899)を設定してください。
動作の仕組み
起動時の非同期ロード :mcp.json に設定された全 server はバックグラウンドで非同期に読み込まれ、メインループをブロックしません。会話はすぐに開始できます
ホットリロード :ユーザーまたは Agent が mcp.json を変更すると、メッセージ処理完了時に変更された server のみが自動でリロードされます。cow の再起動は不要です
フラットな公開 :MCP server が公開する各メソッドは独立した Tool として並列に公開され、LLM が直接選択して呼び出します。二段階の判断は不要です
サポートされるトランスポート
トラブルシューティング
おすすめ MCP マーケットプレイス
各種サードパーティのマーケットプレイスから既製の MCP server を探し、JSON 設定をコピーしてそのまま利用できます。例:
MCP 標準プロトコル(stdio / SSE / Streamable HTTP)に準拠していれば、コードを一切変更せずに CowAgent に統合できます。