> For the complete documentation index, see [llms.txt](https://docs.cotogoto.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cotogoto.ai/cotogoto-mcp-manyuaru.md). # MCP マニュアル ## 1. CotoGoto MCP サーバー概要 ### 1.1 概要 CotoGoto MCP サーバーは、Model Context Protocol（MCP）を利用して CotoGoto および NOBY の機能を AI クライアントから利用できるようにする拡張サーバーです。 MCP に対応したクライアントに設定することで、AI から以下の操作が可能になります。 * CotoGotoとの会話 * 作業開始・完了通知 * 休憩開始・終了通知 *** ## 2. ダウンロード MCP サーバーは以下のページから取得できます。 {% embed url="" %} 最新の `cotogoto-mcp-server.jar` をダウンロードしてください。 *** ## 3. MCP クライアントへの設定 MCP の設定方法は以下の公式ドキュメントを参考にしてください。 {% embed url="" %} {% embed url="" %} *** ## 4. 設定方法 ### 4.1 設定例 MCP クライアントの設定ファイルに以下を追加します。 ```json { "mcpServers": { "cotogoto": { "command": "java", "args": [ "-jar", "/path/to/cotogoto-mcp-server.jar" ], "env": { "COTOGOTO_API_KEY": "YOUR_API_KEY" } } } } ``` *** ### 4.2 設定項目 #### **4.2.1 COTOGOTO\_API\_KEY** CotoGoto API を利用するための認証キーです。 *** ## 5. MCP ツール仕様 ### 5.1 利用可能コマンド一覧
NoTool名概要パラメータ動作内容
1cotogoto_conversation会話を実行message（必須）メッセージを API に送信し応答を取得
2cotogoto_work_start作業開始通知なし「作業開始」を送信
3cotogoto_work_complete作業完了通知なし「作業完了」を送信
4cotogoto_break_start休憩開始通知なし「休憩開始」を送信
5cotogoto_break_end休憩終了通知なし「休憩終了」を送信
### 5.2 各コマンド詳細 #### 5.2.1 cotogoto\_conversation **概要** CotoGoto または NOBY と会話を行います。 質問、相談、作業サポートなどに使用します。 **Tool名** ``` cotogoto_conversation ``` **パラメータ** | 項目 | 必須 | 説明 | | ------- | -- | ---- | | message | 必須 | 会話内容 | **使用例** ```json { "name": "cotogoto_conversation", "arguments": { "message": "今日の作業内容を整理してください" } } ``` **動作** * メッセージを CotoGoto API に送信 * 応答メッセージを返却 *** #### 5.2.2 cotogoto\_work\_start **概要** 作業開始を通知します。 **Tool名** ``` cotogoto_work_start ``` **パラメータ** なし **使用例** ```json { "name": "cotogoto_work_start", "arguments": {} } ``` **動作** ``` 作業開始 ``` を送信します。 *** #### 5.2.3 cotogoto\_work\_complete **概要** 作業完了を通知します。 **Tool名** ``` cotogoto_work_complete ``` **パラメータ** なし **使用例** ```json { "name": "cotogoto_work_complete", "arguments": {} } ``` **動作** ``` 作業完了 ``` を送信します。 *** #### 5.2.4 cotogoto\_break\_start **概要** 休憩開始を通知します。 **Tool名** ``` cotogoto_break_start ``` **パラメータ** なし **使用例** ```json { "name": "cotogoto_break_start", "arguments": {} } ``` **動作** ``` 休憩開始 ``` を送信します。 *** #### 5.2.5 cotogoto\_break\_end **概要** 休憩終了を通知します。 **Tool名** ``` cotogoto_break_end ``` **パラメータ** なし **使用例** ```json { "name": "cotogoto_break_end", "arguments": {} } ``` **動作** ``` 休憩終了 ``` を送信します。 *** ## 6. 応答仕様 すべてのツールは、CotoGoto API から返却されたメッセージを文字列として返します。 *** ## 7. エラー仕様 以下の場合、エラーが発生する可能性があります。 1. APIキーが未設定の場合 2. APIから空レスポンスが返却された場合 3. APIレスポンス形式が不正な場合 *** ## 8. 利用フロー ``` MCPクライアント ↓ ツール呼び出し ↓ CotoGoto MCP サーバー ↓ CotoGoto API ↓ 応答返却 ``` *** ## 9. 想定利用用途 本 MCP サーバーは以下の用途で利用できます。 * AIエージェントによる作業記録 * 作業進捗管理 * 業務サポート会話 * 休憩管理 * 作業ログ生成