ACI.dev 가 지원하는 MCP 서버

[!중요] 이 README는 기본적인 개발 가이드만 다룹니다. ACI.dev MCP 서버에 대한 전체 문서와 튜토리얼은 aci.dev docs 에서 확인하세요.

개요

이 패키지는 ACI.dev 관리 기능(도구)에 액세스하기 위한 두 개의 MCP(Model Context Protocol) 서버를 제공합니다.

aci-mcp-apps : 지정된 앱에서 기능(도구)에 직접 액세스할 수 있는 MCP 서버
aci-mcp-unified : ACI.dev 에서 사용 가능한 모든 기능(도구)을 검색하고 실행하기 위한 두 개의 메타 기능(도구)( ACI_SEARCH_FUNCTIONS 및 ACI_EXECUTE_FUNCTION )을 제공하는 MCP 서버

[!중요] 두 MCP 서버에 대한 자세한 설명과 튜토리얼은 aci.dev 문서를 방문하세요.

로컬에서 MCP 서버 실행

패키지는 PyPI에 게시되었으므로 uvx 사용하여 직접 실행할 수 있습니다.

지엑스피1

$ uvx aci-mcp --help
Usage: aci-mcp [OPTIONS] COMMAND [ARGS]...

  Main entry point for the package.

Options:
  --help  Show this message and exit.

Commands:
  apps-server     Start the apps-specific MCP server to access tools...
  unified-server  Start the unified MCP server with unlimited tool access.

MCP 클라이언트와의 통합

다양한 MCP 클라이언트로 MCP 서버를 구성하는 방법에 대한 자세한 내용은 통합 MCP 서버 및 앱 MCP 서버 섹션을 참조하세요.

도커

# Build the image
docker build -t aci-mcp .

# Run the unified server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# Run the apps server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp apps-server --apps <APP1,APP2,...> --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

디버깅

MCP 검사기를 사용하여 서버를 디버깅할 수 있습니다.

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

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

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 실행하면 서버의 로그가 표시되어 문제를 디버깅하는 데 도움이 될 수 있습니다.