ACI.dev MCPサーバーの使用方法

今日の急速に進化する開発環境において、モデルコンテキストプロトコル（MCP）サーバーは、AIアシスタントと専門データソースをつなぐ強力なツールとして登場しました。 ACI.dev MCPサーバーは、統一されたインターフェースを通じて複数のアプリ機能へのアクセスを提供する包括的なソリューションを提供している点で際立っています。

ACI.devは、異なる開発ニーズに対応するために設計された2種類のMCPサーバーを提供しています：

アプリMCPサーバー：このサーバーは、選択した特定のアプリからの機能に直接アクセスを提供します。ほとんどのMCPサーバーが1つのアプリに制限されるのに対し、ACI.devのアプリサーバーは、1つのサーバー構成に複数のアプリを含めることを可能にします。

ユニファイドMCPサーバー：この革新的なサーバーは、ACI.devプラットフォームで利用可能な任意の機能を発見し実行する2つのメタ機能を提供することで、異なるアプローチを取ります。この動的なアプローチにより、すべてのツールを事前にリストする必要がなくなります。

ACI.dev MCPサーバーの力は、次の機能にあります：

異なるMCPサーバー間で切り替えることなく複数のアプリ機能にアクセス
特定のニーズに基づいて関連ツールを動的に発見
異なるアプリ間でシームレスに機能を実行
必要なときにのみ関連ツールをロードすることでコンテキストウィンドウの使用を削減

API開発者にとって、これらの機能は、AIアシスタントが複数のアプリケーションからツールにアクセスし利用できるようにすることで、より効率的なワークフローに変換されます。

💡

プロのヒント：ACI.dev MCPサーバーが優れた複数アプリ機能へのアクセスを提供する一方で、Apidog MCPサーバーは、API開発に特化した機能を提供します。Apidog MCPサーバーは、AIアシスタントにAPI仕様への直接アクセスを提供し、生成されたコードが設計文書に完璧に一致するようにします。

ボタン

ACI.dev MCPサーバーの設定：ステップバイステップガイド

ACI.dev MCPサーバーの開始方法には、いくつかの簡単な手順が必要です。このセクションでは、両方のサーバータイプの完全な設定プロセスを説明します。

ACI.dev MCPサーバーの前提条件

設定プロセスを始める前に、次のものを確認してください：

ACI.dev APIキー（ACI開発プラットフォームから取得可能）
UVパッケージマネージャーがインストールされていること
設定したアプリを確認し、platform.aci.devのエージェントについてallowed_appsに設定しました。
同じlinked-account-owner-idの下にアプリ固有のアカウントをリンクしました。
MCPをサポートするIDE（例：）

Claude Desktop
Cursor
適切な拡張機能を持つVS Code

UVパッケージマネージャーのインストール

まず、まだインストールしていない場合はUVパッケージマネージャーをインストールしてください：

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

アプリMCPサーバーの設定

アプリMCPサーバーは、選択した特定のアプリからの機能に直接アクセスを提供します：

アプリを選択してください

アクセスしたいアプリを特定してください。利用可能なアプリはplatform.aci.dev/appsで確認できます。

サーバーを実行

uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

<LINKED_ACCOUNT_OWNER_ID>をplatform.aci.devから取得したアカウントIDに置き換えてください。

IDEの設定

Claude Desktopの場合は、claude_desktop_config.jsonに次を追加してください：

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Cursorの場合は、mcp.jsonに追加してください：

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

ユニファイドMCPサーバーの設定

ユニファイドMCPサーバーは、2つのメタ機能を持つより動的なアプローチを提供します：

ACI_SEARCH_FUNCTIONS_WITH_INTENT - あなたの意図/ニーズに基づいて機能を発見します
ACI_EXECUTE_FUNCTION - 検索によって発見された任意の機能を実行します

サーバーを実行

uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

IDEの設定

Claude Desktopの場合は、claude_desktop_config.jsonに次を追加してください：

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Cursorの場合は、mcp.jsonに追加してください：

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

セットアップの確認

セットアップが正しく機能しているかを確認するには：

アプリサーバーの場合：AIアシスタントに指定されたアプリの機能を使用するように求めてください：

"Brave Searchを使用してAPI開発に関する最近のニュースを検索してください"

ユニファイドサーバーの場合：AIアシスタントに機能を発見し使用するように求めてください：

"REST APIのベストプラクティスに関する情報を見つける必要があります"

AIは、指定された機能を直接使用すること（アプリサーバー）で応答するか、最初に必要な機能を発見し、次に実行すること（ユニファイドサーバー）で応答する必要があります。

API開発にはApidog MCPサーバーを使用する

ACI.dev MCPサーバーは複数のアプリ機能へのアクセスを提供するのに優れていますが、API開発にはAPI仕様や実装を扱うために特別に設計されたツールが必要です。ここで、Apidog MCPサーバーが焦点となり、API駆動の開発ワークフローに特化した機能を提供し、ACI.devサーバーの汎用機能を補完します。

Apidog MCPサーバーを使用したAPI開発の向上

Apidog MCPサーバーは、API開発の方法論において重要な前進を意味し、特にAPI仕様にAIアシスタントが直接アクセスできるようにすることに焦点を当てています。一般的なMCPサーバーと異なり、Apidog MCPサーバーはAPI開発のために特に設計されており、仕様と実装の完璧な整合性を保証します。

Apidog MCPサーバーの動作

設定が完了すると、Apidog MCPサーバーはローカルマシンのAPI仕様データを自動的に読み取りキャッシュします。これにより、AIアシスタントは開発中にこのデータをシームレスに取得して利用できます。プロセスは以下のように機能します：

API仕様への接続：Apidog MCPサーバーは、Apidogプロジェクト、公開された文書、またはOpenAPIファイルにあるAPI仕様に直接リンクします。
データのローカルキャッシュ：仕様は迅速にアクセスできるようにキャッシュされます。
AIへのコンテキスト提供：AIにAPIについて尋ねると、正確な仕様にアクセスできます。
コード生成の有効化：AIはAPI設計に完全に一致するコードを生成できます。

この特化したアプローチにより、すべてのAI支援の開発がAPI仕様と完全に整合することが保証され、設計と実装の一般的なズレが解消されます。

Apidog MCPサーバーの設定

Apidog MCPサーバーの設定には、いくつかの簡単な手順が必要です：

前提条件：

Node.js（バージョン18以上）
MCPをサポートするIDE（Cursor、VS Code + Clineプラグイン）

データソースを選択してください：Apidog MCPサーバーは3つの異なるデータソースをサポートしています：

Apidogプロジェクト：チーム内のAPI仕様にアクセスするため
オンラインAPIドキュメント：Apidogを通じて公開されたAPIドキュメントを読むため
OpenAPIファイル：ローカルまたはオンラインのSwagger/OpenAPIファイルを扱うため

IDEでMCPを設定してください：データソースとしてApidogプロジェクトを使用する場合（Windowsの例）：

{
 "mcpServers": {
   "API仕様": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

構成の確認：AIアシスタントに尋ねてテストしてください：

"MCPを介してAPI仕様を取得し、プロジェクトにいくつのエンドポイントが存在するか教えてください"

Apidog MCPを使用した強力なAPI開発ワークフロー

Apidog MCPサーバーは、API開発を変革する特化したワークフローを可能にします：

仕様に基づくコード生成

"MCPを使用してAPI仕様を取得し、'Product'スキーマおよび関連スキーマのJavaレコードを生成してください"

仕様変更時の実装更新

"API仕様に基づいて、'Product' DTOに新しいフィールドを追加してください"

コードにドキュメントを追加

"API仕様に基づいて、'Product'クラスの各フィールドにコメントを追加してください"

完全なAPI実装の生成

"API仕様に従って、'/users'エンドポイントに関連するすべてのMVCコードを生成してください"

結論：開発ニーズに合ったMCPサーバーの選択

特化したMCPサーバーの登場は、AI支援の開発において重要な進展を示しています。ACI.dev MCPサーバーは複数のアプリ機能へのアクセスを提供するのに優れており、Apidog MCPサーバーはAPI実装との完璧な整合性を確保しつつAPI開発に特化しています。

開発者にとって、これらのツールは相補的な目的を果たします：

ACI.dev MCPサーバー：複数のアプリからの機能にアクセスする必要がある場合や、特定のニーズに基づいて動的な機能発見を望む場合に理想的です。
Apidog MCPサーバー：APIを実装する際に、コードがAPI仕様と完全に一致することを確保するのに最適です。

特定の要件に基づいてこれらの特化したツールをワークフローに組み込むことにより、生産性とコードの質を大幅に向上させることができます。これらのMCPサーバーは、開発の実践に対する根本的な変化を表しており、作業をより効率的、正確、最終的にはより楽しいものにしています。