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 실행하면 서버의 로그가 표시되어 문제를 디버깅하는 데 도움이 될 수 있습니다.