テーマ
acomo MCP Server
MCP連携の用途と、通常のAPI連携との使い分けを説明します。
対象読者
開発者
前提
- 組織の管理者から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連携を先に 検討してください。
- バッチ処理や、既存業務システムからのデータの作成、参照、更新、削除を行う場合
- 権限と監査を明示的に制御するサーバー間連携を行う場合
利用前に確認すること
- 組織の管理者からMCP利用可否とエンドポイント情報が案内されていること
- acomo MCP ServerのGitHubリポジトリに記載された対応環境を満たすこと
- 同等の操作がOpenAPI上で確認でき、API連携へ切り替えられること
うまくいかないとき
MCPの接続情報やサポート範囲が不明な場合は、システム管理者または サポート問い合わせ に問い合わせてください。API単体で実現できるかは 代表的な連携例 を参照してください。