テーマ
acomo MCP Server
MCP 連携の用途と、通常の API 連携との使い分けを説明します。
対象読者
開発者（AI エージェントや IDE 連携を検討する方）
前提
- 組織の管理者からMCPの利用を許可されていること
- 接続先エンドポイントと認証情報が案内されていること
- 通常のREST APIでは要件を満たせないことを確認していること
知っておくこと
MCP Server は、AI アシスタントや対応ツールから acomo の操作を プロトコル経由 で行うための 高度な連携 です。公開ドキュメントの主導線は REST API と OpenAPI です。
| 比較 | REST API | MCP Server |
|---|---|---|
| 契約 | OpenAPI仕様書 | MCP ツール定義 |
| 認証 | Bearer + x-tenant-id | 組織ごとの MCP エンドポイント設定 |
| 向き | 一般的なシステム連携 | AI エージェント・開発ツール連携 |
公開されているサーバーのセットアップと対応ツールは、acomo MCP ServerのGitHubリポジトリで確認できます。開発背景と実装例は、acomo MCP Serverの開発記事を参照してください。
接続先、認証情報、利用を許可する操作は、組織の管理者が定めた運用に従ってください。
いつ MCP を検討するか
- IDE やチャット型エージェントから、ワークフロー操作を ツール呼び出し として統合したい
- OpenAPI を直接組み込むより、MCP クライアント側の抽象化を使いたい
次の場合は API 連携を先に 検討してください。
- バッチ処理、既存業務システムからの CRUD
- 権限・監査を明示的に制御したいサーバー間連携
利用前に確認すること
- 組織の管理者から MCP 利用可否とエンドポイント情報が案内されていること
- acomo MCP ServerのGitHubリポジトリに記載された対応環境を満たすこと
- 同等の操作が OpenAPI 上で確認できること（フォールバック経路）
うまくいかないとき
MCP の接続情報やサポート範囲が不明な場合は、テナント管理者または サポート問い合わせ に問い合わせてください。API 単体で実現できるかは 代表的な連携例 を参照してください。