ACI.dev 가 지원하는 MCP 서버

MCP 서버에 대한 전체 문서와 튜토리얼은 aci.dev docs 에서 확인하세요.

목차

• ACI.dev가 지원하는 MCP 서버
  • 목차
  • 개요
  • 필수 조건
  • 설치
  • 용법
    • 앱 서버
    • 통합 서버
  • 두 가지 서버 유형 이해
    • 앱 서버
    • 통합 서버
  • 구성
  • 자주 묻는 질문
  • 디버깅

개요

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 서버

필수 조건

이 패키지를 사용하기 전에 다음을 수행해야 합니다(자세한 내용은 튜토리얼을 참조하세요).

1. ACI.dev API 키로 ACI_API_KEY 환경 변수를 설정합니다.
2. platform.aci.dev 에서 에이전트의 allowed_apps 에 앱을 구성하고 설정합니다.
3. 나중에 MCP 서버를 시작하기 위해 제공할 동일한 --linked-account-owner-id 로 앱별 계정을 연결합니다.

설치

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

지엑스피1

용법

앱 서버

앱 서버는 특정 앱의 기능(도구)에 직접 액세스할 수 있도록 합니다. --apps 매개변수를 사용하여 하나 이상의 앱을 사용할 수 있습니다. (사용 가능한 앱 목록은 ACI.dev를 참조하세요.)

통합 서버

통합 서버는 ACI.dev 에서 사용 가능한 모든 기능(도구)을 검색하고 실행할 수 있는 두 개의 메타 기능(도구)을 제공합니다. 이러한 기능(도구)이 서버에 직접 나열되어 있지 않더라도 마찬가지입니다.

기능(도구)은 사용자의 의도/요구 사항에 따라 동적으로 검색되고 실행됩니다. 수천 개의 도구가 LLM 컨텍스트 창을 차지하거나 여러 MCP 서버를 통합해야 하는 걱정을 할 필요가 없습니다.

두 가지 서버 유형 이해

MCP 서버에 대한 전체 문서와 튜토리얼은 aci.dev docs 에서 확인하세요.

앱 서버

앱 서버는 --apps 매개변수로 지정한 특정 앱 기능/도구에 직접 액세스할 수 있도록 합니다. 이러한 도구는 MCP 클라이언트(예: Claude Desktop, Cursor 등)가 이 서버와 상호 작용할 때 도구 목록에 직접 표시됩니다.

통합 서버

통합 서버는 앱별 도구를 직접 노출하지 않습니다. 대신 두 가지 메타 함수(도구)를 제공합니다.

1. ACI_SEARCH_FUNCTIONS : 사용자의 의도/요구 사항에 따라 기능(도구)을 검색합니다.
2. ACI_EXECUTE_FUNCTION : 검색을 통해 발견된 모든 함수(도구)를 실행합니다.

이 접근 방식을 통해 MCP 클라이언트는 ACI.dev 플랫폼에서 사용 가능한 모든 기능을 미리 나열할 필요 없이 동적으로 검색하고 사용할 수 있습니다. 필요에 따라 적합한 도구를 검색하여 실행할 수 있습니다.

구성(MCP 클라이언트와의 통합)

다양한 MCP 클라이언트로 MCP 서버를 구성하는 방법에 대한 자세한 내용은 통합 MCP 서버 및 앱 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 매개변수를 사용하여 앱 서버에서 사용할 앱 목록을 쉼표로 구분하여 지정할 수 있습니다. 앱 이름 사이에 공백을 넣지 마세요.
• 하나의 앱에서만 기능(도구)을 사용할 수 있나요?네, --apps 매개변수로 (하나의) 앱 이름을 지정하면 하나의 앱에서만 함수(도구)를 사용할 수 있습니다.

디버깅

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

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