ACI.dev搭載の MCP サーバー

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

目次

• ACI.dev 搭載の MCP サーバー
  • 目次
  • 概要
  • 前提条件
  • インストール
  • 使用法
    • アプリサーバー
    • 統合サーバー
  • 2種類のサーバータイプを理解する
    • アプリサーバー
    • 統合サーバー
  • 構成
  • よくある質問
  • デバッグ

概要

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

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

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

前提条件

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

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

インストール

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

使用法

アプリサーバー

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

統合サーバー

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

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

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

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

アプリサーバー

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

統合サーバー

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

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

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

構成（MCP クライアントとの統合）

さまざまな MCP クライアントで MCP サーバーを構成する方法の詳細については、 「Unified MCP サーバー」および「Apps MCP サーバー」のセクションを参照してください。

よくある質問

• ACI_API_KEYを取得するにはどうすればよいですか?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 インスペクタを使用してサーバーをデバッグできます。

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