오늘날 급변하는 개발 환경에서 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 서버는 AI 어시스턴트와 특화된 데이터 소스를 연결하는 강력한 도구로 떠올랐습니다. ACI.dev MCP 서버는 통합된 인터페이스를 통해 여러 앱 기능에 대한 접근성을 제공하는 포괄적인 솔루션을 제공하여 두각을 나타냅니다.
ACI.dev는 서로 다른 개발 요구 사항을 해결하기 위해 설계된 두 가지 유형의 MCP 서버를 제공합니다:
앱 MCP 서버: 이 서버는 특정 앱에서 선택한 기능에 직접 접근할 수 있도록 합니다. 대부분의 MCP 서버가 단일 앱으로 제한되는 것과 달리, ACI.dev의 앱 서버에서는 단일 서버 구성에서 여러 앱을 포함할 수 있습니다.
통합 MCP 서버: 이 혁신적인 서버는 ACI.dev 플랫폼에서 사용할 수 있는 모든 기능을 검색하고 실행할 수 있는 두 가지 메타 기능을 제공하는 다른 접근 방식을 취합니다. 이 동적 접근 방식은 모든 도구를 미리 나열할 필요성을 없애줍니다.
ACI.dev MCP 서버의 장점은 다음과 같은 능력에 있습니다:
- 다양한 앱 기능에 접근하여 서로 다른 MCP 서버 간 전환 없이도 사용 가능
- 특정 요구 사항에 따라 관련 도구를 동적으로 발견
- 다양한 앱에서 기능을 원활하게 실행할 수 있음
- 필요할 때만 관련 도구를 로드하여 컨텍스트 창 사용량을 줄임
API 개발자에게 이러한 기능은 AI 어시스턴트가 여러 별도의 연결을 관리하는 오버헤드 없이 다양한 애플리케이션의 도구에 접근하고 활용할 수 있는 보다 간소화된 워크플로우로 변환됩니다.
ACI.dev MCP 서버 설정: 단계별 가이드
ACI.dev MCP 서버 시작하기는 몇 가지 간단한 단계를 요구합니다. 이 섹션에서는 두 서버 유형에 대한 전체 설정 프로세스를 안내합니다.
ACI.dev MCP 서버를 위한 전제 조건
설정을 시작하기 전에 다음 사항을 확인하세요:
- ACI.dev API 키 (ACI 개발 플랫폼에서 얻을 수 있음)
- UV 패키지 관리자 설치됨
- 구성된 앱이 있으며 platform.aci.dev에서 에이전트의
allowed_apps에 설정됨 - 같은
linked-account-owner-id아래에서 앱 전용 계정 연결됨 - MCP를 지원하는 IDE (예:)
- 클로드 데스크탑
- 커서
- 적절한 확장 기능이 있는 VS 코드
UV 패키지 관리자 설치하기
먼저, UV 패키지 관리자를 설치하지 않았다면 설치합니다:
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv앱 MCP 서버 설정하기
앱 MCP 서버는 선택한 특정 앱에서 기능에 직접 접근할 수 있도록 합니다:
앱 선택하기
접근하고자 하는 앱을 식별합니다. 사용 가능한 앱은 platform.aci.dev/apps에서 찾을 수 있습니다.
서버 실행하기
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID><LINKED_ACCOUNT_OWNER_ID>를 platform.aci.dev에서 귀하의 계정 ID로 교체합니다.
IDE 구성하기
클로드 데스크탑의 경우, claude_desktop_config.json에 다음을 추가합니다:
{
"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-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>"
}
}
}
}통합 MCP 서버 설정하기
통합 MCP 서버는 두 가지 메타 기능으로 보다 동적 접근 방식을 제공합니다:
ACI_SEARCH_FUNCTIONS_WITH_INTENT- 의도/필요에 따라 기능 검색ACI_EXECUTE_FUNCTION- 검색된 모든 기능 실행
서버 실행하기
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>IDE 구성하기
클로드 데스크탑의 경우, claude_desktop_config.json에 다음을 추가합니다:
{
"mcpServers": {
"aipolabs-mcp-unified": {
"command": "uvx",
"args": ["aipolabs-mcp", "unified-server", "--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>"
}
}
}
}설정 확인하기
설정이 올바르게 작동하는지 확인하려면:
앱 서버의 경우: AI 어시스턴트에게 지정된 앱 중 하나에서 기능을 사용하도록 요청합니다:
"브레이브 서치를 사용하여 API 개발에 대한 최신 뉴스를 검색하세요."통합 서버의 경우: AI 어시스턴트에게 기능을 검색하고 사용하도록 요청합니다:
"REST API 모범 사례에 대한 정보를 찾아주세요."AI는 지정된 기능을 직접 사용하는 것(앱 서버) 또는 먼저 검색한 후 적절한 기능을 실행하는 것(통합 서버)으로 응답해야 합니다.
API 개발을 위한 Apidog MCP 서버 사용
ACI.dev MCP 서버가 여러 앱 기능에 대한 접근을 제공하는 데 탁월하지만, API 개발은 일반적으로 API 사양 및 구현 작업에 특별히 설계된 도구가 필요합니다. 이 점에서 Apidog MCP 서버가 주목받으며, API 기반 개발 워크플로우에 적합하게 설계된 기능을 제공합니다.
Apidog MCP 서버로 API 개발 강화하기
Apidog MCP 서버는 API 개발 방법론에서 중요한 발전을 나타내며, API 사양을 AI 어시스턴트가 직접 접근할 수 있도록 만든 데 초점을 맞추고 있습니다. 일반적인 MCP 서버와 달리, Apidog MCP 서버는 API 개발을 위해 특별히 설계되어 사양과 구현 사이의 완벽한 일치를 보장합니다.
Apidog MCP 서버 작동 방식
설정이 완료되면 Apidog MCP 서버는 자동으로 API 사양 데이터를 로컬 컴퓨터에서 읽고 캐시합니다. 이를 통해 AI 어시스턴트는 개발 중 이 데이터를 원활하게 검색하고 활용할 수 있습니다. 이 프로세스는 다음과 같이 작동합니다:
- API 사양 연결: Apidog MCP 서버는 Apidog 프로젝트, 게시된 문서 또는 OpenAPI 파일 형식의 API 사양에 직접 연결됩니다.
- 데이터 로컬 캐싱: 사양은 빠른 접근을 위해 캐시됩니다.
- AI에게 컨텍스트 제공: AI에게 API에 대해 질문할 때 정확한 사양에 접근할 수 있습니다.
- 코드 생성 가능: AI는 API 설계와 완벽하게 일치하는 코드를 생성할 수 있습니다.
이 전문화된 접근 방식은 모든 AI 지원 개발이 API 사양과 완벽하게 조화를 이루도록 보장하며, 디자인과 구현 사이의 흔한 불일치를 제거합니다.
Apidog MCP 서버 설정하기
Apidog MCP 서버 설정은 몇 가지 간단한 단계를 요구합니다:
전제 조건:
- Node.js (버전 18 이상)
- MCP를 지원하는 IDE (커서, VS 코드 + Cline 플러그인)
데이터 소스 선택하기: Apidog MCP 서버는 세 가지 서로 다른 데이터 소스를 지원합니다:
- Apidog 프로젝트: 팀 내에서 API 사양에 접근하기 위해
- 온라인 API 문서: Apidog를 통해 게시된 API 문서를 읽기 위해
- OpenAPI 파일: 로컬 또는 온라인 Swagger/OpenAPI 파일을 작업하기 위해
IDE에서 MCP 구성하기: Apidog 프로젝트를 데이터 소스로 사용할 경우 (Windows 예시):
{
"mcpServers": {
"API specification": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"apidog-mcp-server@latest",
"--project=<project-id>"
],
"env": {
"APIDOG_ACCESS_TOKEN": "<access-token>"
}
}
}
}
구성 확인하기: AI 어시스턴트에게 다음과 같이 요청하여 테스트합니다:
"MCP를 통해 API 사양을 가져와서 프로젝트에 몇 개의 엔드포인트가 있는지 알려주세요."Apidog MCP와 함께하는 강력한 API 개발 워크플로우
Apidog MCP 서버는 API 개발을 혁신하는 특화된 워크플로우를 가능하게 합니다:
사양에 따른 코드 생성
"MCP를 사용하여 API 사양을 가져오고 '제품' 스키마 및 관련 스키마에 대한 Java 레코드를 생성하세요."사양 변경 시 구현 업데이트
"API 사양에 따라 '제품' DTO에 새로운 필드를 추가하세요."코드에 문서 추가하기
"API 사양에 따라 '제품' 클래스의 각 필드에 주석을 추가하세요."완전한 API 구현 생성하기
"API 사양에 따라 '/users' 엔드포인트와 관련된 모든 MVC 코드를 생성하세요."결론: 개발 필요에 맞는 적절한 MCP 서버 선택하기
특화된 MCP 서버의 출현은 AI 지원 개발의 중요한 발전을 나타냅니다. ACI.dev MCP 서버는 다중 앱 기능 접근에 탁월하며, Apidog MCP 서버는 API 개발을 특별히 강조하여 사양과 구현 간의 완벽한 일치를 보장합니다.
개발자에게 이 도구는 서로 보완적인 목적을 가지고 있습니다:
- ACI.dev MCP 서버: 여러 앱의 기능에 접근하려거나 특정 요구에 기반한 동적 기능 검색이 필요할 때 이상적입니다.
- Apidog MCP 서버: API를 구현하고 코드가 API 사양과 완벽하게 일치하는 것을 보장할 때 적합합니다.
특정 요구 사항에 따라 이러한 특화된 도구를 워크플로우에 통합함으로써 생산성과 코드 품질을 크게 향상시킬 수 있습니다. 이러한 MCP 서버는 개발 관행의 근본적인 변화를 나타내며, 작업을 보다 효율적이고 정확하며 궁극적으로 더 즐겁게 만들어줍니다.