ACI.dev搭載の MCP サーバー

MCP サーバーに関する完全なドキュメントとチュートリアルについては、 aci.dev docsをご覧ください。

概要

MCP サーバーに関する完全なドキュメントとチュートリアルについては、 aci.dev docsをご覧ください。

このパッケージは、 ACI.devが管理する関数 (ツール) にアクセスするための 2 つの Model Context Protocol (MCP) サーバーを提供します。

aipolabs-mcp-apps : 指定されたアプリの機能（ツール）への直接アクセスを提供するMCPサーバー
aipolabs-mcp-unified : ACI.devで利用可能なすべての関数 (ツール) を検出して実行するための 2 つのメタ関数 (ツール) ( ACI_SEARCH_FUNCTIONS_WITH_INTENTとACI_EXECUTE_FUNCTION ) を提供する MCP サーバー

前提条件

このパッケージを使用する前に、次の操作を行う必要があります (詳細についてはチュートリアルを参照してください)。

AIPOLABS_ACI_API_KEY環境変数をACI.dev APIキーで設定します。
アプリを構成し、 platform.aci.dev上のエージェントのallowed_appsに設定します。
後でMCPサーバーを起動するために指定する同じ--linked-account-owner-idでアプリ固有のアカウントをリンクします。

インストール

パッケージは PyPI に公開されているため、 uvxを使用して直接実行できます。

# Install uv if you don't have it already
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

使用法

アプリサーバー

アプリサーバーは、特定のアプリの機能（ツール）に直接アクセスできるようにします。-- --appsパラメータを使用して、使用するアプリを1つ以上指定できます。（利用可能なアプリの一覧については、 ACI.devをご覧ください。）

# Using stdio transport (default)
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# Using SSE transport with custom port
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --transport sse --port 8000

統合サーバー

統合サーバーは、サーバー内に直接リストされていない場合でも、 ACI.devで利用可能な任意の関数 (ツール) を検出して実行するための 2 つのメタ関数 (ツール) を提供します。

関数（ツール）は、ユーザーの意図やニーズに基づいて動的に検索・実行されます。LLMのコンテキストウィンドウを何千ものツールで占有したり、複数のMCPサーバーを統合したりする必要はありません。

# During functions (tools) search/discovery, allow discoverability of all functions (tools) available on ACI.dev
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# During functions (tools) search/discovery, limit to only functions (tools) accessible by the requesting agent (identified by AIPOLABS_ACI_API_KEY)
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --allowed-apps-only

2種類のサーバータイプを理解する

MCP サーバーに関する完全なドキュメントとチュートリアルについては、 aci.dev docsをご覧ください。

アプリサーバー

アプリサーバーは、 --appsパラメータで指定した特定のアプリ機能／ツールへの直接アクセスを提供します。これらのツールは、MCPクライアント（Claude Desktop、Cursorなど）がこのサーバーと通信する際に、ツールリストに直接表示されます。

統合サーバー

統合サーバーはアプリ固有のツールを直接公開しません。代わりに、2つのメタ関数（ツール）を提供します。

ACI_SEARCH_FUNCTIONS_WITH_INTENT : 意図/ニーズに基づいて関数（ツール）を検出します
ACI_EXECUTE_FUNCTION : 検索によって発見された任意の関数（ツール）を実行します。

このアプローチにより、MCPクライアントはACI.devプラットフォームで利用可能なあらゆる機能を動的に検出して利用できるようになります。事前にすべての機能をリストアップする必要はありません。ニーズに基づいて適切なツールを検索し、実行することができます。

構成

MCP サーバーに関する完全なドキュメントとチュートリアルについては、 aci.dev docsをご覧ください。

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>"]
    }
  }
}

アプリ固有のアクセスの場合:

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

カーソルとの使用

カーソル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>"
        }
      }
    }
  }

アプリ固有のアクセスの場合:

{
  "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>"
        }
    }
  }
}

よくある質問

AIPOLABS_ACI_API_KEYを取得するにはどうすればよいですか?AIPOLABS_ACI_API_KEYは、 ACI.devプロジェクトの API キーです。ACI.devプロジェクト設定で確認できます。
アプリを構成してアクセスを許可するにはどうすればよいですか?ACI.devプロジェクト設定でアプリを構成し、アクセスを許可することができます。
LINKED_ACCOUNT_OWNER_ID取得するにはどうすればよいですか?LINKED_ACCOUNT_OWNER_IDは、関数にアクセスするために使用するアカウントのIDです。ACI.devプロジェクト設定で確認できます。
アプリサーバーではなく統合サーバーを使用する利点は何ですか?現在のMCPサーバーのほとんどは、通常は単一のアプリの特定の機能（ツール）セットに制限されています。複数のアプリの機能を使用する必要がある場合は、複数のMCPサーバーを統合する必要があります。しかし、複数のMCPサーバーを統合することによる管理オーバーヘッドを許容できる場合でも、すべてのツールがLLMのコンテキストウィンドウに一度に読み込まれるため、LLMツールの呼び出しパフォーマンスが低下する可能性があります。ただし、統合サーバーを使用すると、何千ものツールが LLM のコンテキストウィンドウを占有したり、複数の MCP サーバーを統合したりする必要を心配することなく、 ACI.devで利用可能な任意の機能を動的に検出して実行できます。
アプリサーバーで使用するアプリのリストを指定するにはどうすればよいですか?--appsパラメータを使用して、アプリサーバーで使用するアプリをカンマ区切りのリストで指定できます。アプリ名の間にスペースを入れないようにしてください。
1つのアプリの機能（ツール）だけを使用できますか?はい、 --appsパラメータで (1 つの) アプリ名を指定することにより、1 つのアプリの機能 (ツール) のみを使用できます。

デバッグ

MCP インスペクタを使用してサーバーをデバッグできます。

# For unified server
npx @modelcontextprotocol/inspector uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# For apps server
npx @modelcontextprotocol/inspector uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

tail -n 20 -f ~/Library/Logs/Claude/mcp*.logを実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。

AIPOLabs MCP Server

Integrations

ACI.dev搭載の MCP サーバー

目次

概要

前提条件

インストール

使用法

アプリサーバー

統合サーバー

2種類のサーバータイプを理解する

アプリサーバー

統合サーバー

構成

Claude Desktopでの使用

カーソルとの使用

よくある質問

デバッグ