Apollo MCP 서버

Apollo MCP 서버는 Apollo CLI 기능을 AI 에이전트가 호출할 수 있는 도구로 노출합니다. Model Context Protocol(MCP)을 사용하는 에이전트는 환경 조회, 리소스 관리와 Apollo 문서 검색을 수행할 수 있습니다. 제공 도구는 약 97개이며 정확한 목록은 연결한 서버에서 조회합니다.

연결과 인증

<apollo-hub-host>는 허브의 실제 호스트 이름으로 바꾸며 https://를 중복해서 넣지 않습니다. 토큰은 CLI 인증 절차에 따라 만듭니다.

Authorization: Bearer <your-apollo-token>

다음은 연결 설정 형태를 보여 주는 JSON 예시입니다. 주소와 토큰은 예시이며, 에이전트 제품이 요구하는 상위 설정 구조에 맞추어 넣습니다.

{
  "type": "http",
  "url": "https://apollo.palantircloud.com/apollo-mcp/mcp",
  "headers": {
    "Authorization": "Bearer <your-token>"
  }
}

같은 값의 YAML 표현은 다음과 같습니다.

type: http
url: https://apollo.palantircloud.com/apollo-mcp/mcp
headers:
  Authorization: "Bearer <your-token>"

실제 토큰을 공유 저장소나 일반 대화에 넣지 않습니다. 에이전트가 이 연결을 통해 요청하는 작업은 토큰의 권한 범위에 영향을 받으므로 필요한 계정과 리소스 범위를 정하여 연결합니다.

읽기 작업으로 연결 확인

설정한 에이전트에게 사용 가능한 Apollo 도구 목록을 요청합니다. 이어서 배포 환경 문서를 검색하도록 요청하고 apollo_docs_search가 호출되는지 확인합니다. 도구 개수가 대략적인 기준과 다르다는 사실만으로 연결 실패라고 단정하지 말고 실제 도구 목록과 조회 결과를 확인합니다.

연결 확인에는 환경 생성, 배포, 권한 변경 같은 작업이 필요하지 않습니다. 실제 리소스 변경을 요청할 때는 작업 대상, 값과 승인 절차를 별도로 확인해야 합니다.

GraphQL 스키마 검색

Apollo 리소스 조회의 주 인터페이스는 GraphQL입니다. 스키마 검색 도구로 다음 내용을 찾을 수 있습니다.

• 작업에 맞는 query 또는 mutation
• 특정 유형에서 조회 가능한 필드
• 작업의 입력 매개변수
• 필드에 사용할 열거형 값

검색한 스키마를 바탕으로 요청을 구성합니다. mutation은 리소스를 변경할 수 있으므로 조회 요청과 구분합니다.

문서 검색과 읽기

에이전트는 환경, 모듈과 릴리스 채널 같은 개념을 확인하고, 모듈 배포나 변경 요청 처리 절차, 모듈과 개별 개체를 선택하는 기준, 오류 메시지의 의미를 찾는 데 이 도구를 사용할 수 있습니다. 문서 검색 결과와 실제 허브의 권한 및 스키마는 별도로 확인해야 합니다.