Ctrlk

MCP 연동 가이드

AI 코딩 도구에서 아키스케치 API 문서를 직접 검색할 수 있는 MCP 서버 연동 방법을 안내합니다.

아키스케치 API 문서는 MCP(Model Context Protocol) 서버를 제공합니다. AI 코딩 도구(Claude Desktop, Cursor, VS Code 등)에 연결하면 아키스케치 API 문서를 자연어로 검색하고, AI의 도움을 받아 연동 작업을 효율적으로 진행할 수 있습니다.

1. MCP란?

MCP(Model Context Protocol)는 AI 모델에게 외부 데이터를 전달하는 표준 프로토콜입니다.

아키스케치 MCP 서버를 연결하면 AI가 API 문서를 직접 검색하여 최신 스펙을 기반으로 정확한 답변과 코드를 제공합니다. 문서를 직접 탐색하거나, AI에게 문서 내용을 복사해서 전달할 필요가 없습니다.

2. MCP 서버 정보

항목
값

MCP 엔드포인트

https://archisketch-docs.gitbook.io/archisketch/~gitbook/mcp

전송 방식

Streamable HTTP

인증

불필요 (공개 문서)

접근 범위

아키스케치 API 문서 (공개된 최신 버전)

3. AI 도구별 설정 방법

각자 사용하고 있는 AI 혹은 개발 도구의 MCP 설정 방법에 따라 아래 JSON 설정을 추가하거나, 다음에서 제공하는 명령어를 활용하면 AI 도구가 MCP 서버와 연결되어 문서를 검색하거나 연동 관련 질문을 이해할 수 있게 됩니다.

{
  "mcpServers": {
    "archisketch-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://archisketch-docs.gitbook.io/archisketch/~gitbook/mcp"
      ]
    }
  }
}

3.1 Claude Code

다음 명령어로 MCP가 추가되었는지 확인합니다.

3.2 Cursor / VS Code

설정 파일(mcp.json 또는 .cursor/mcp.json)에 위의 JSON 설정을 추가하세요.

4. 연결 확인

설정이 완료되면 AI 도구에서 아키스케치 API에 대해 질문해 보세요.

AI가 API 문서를 검색하여 엔드포인트, 파라미터, 응답 형식 등을 구체적으로 안내하면 정상 연결된 것입니다.

연결이 되지 않는 경우:

  • 엔드포인트 URL이 정확한지 확인

  • 네트워크에서 archisketch-docs.gitbook.io에 접근 가능한지 확인

  • AI 도구를 재시작했는지 확인

  • JSON 문법 오류가 없는지 확인

5. 활용 예시

5.1 API 연동 시작

5.2 특정 API 스펙 조회

5.3 연동 코드 작성

AI가 문서에서 인증 API 스펙을 검색한 뒤, 정확한 엔드포인트와 파라미터를 반영한 코드를 생성합니다.

5.4 에러 트러블슈팅

6. FAQ

Q. MCP를 사용하지 않고도 API 연동할 수 있나요?

A. 네. MCP는 AI 도구를 통한 개발 편의 기능입니다. 기존처럼 API 문서 사이트에서 직접 스펙을 확인하며 연동할 수 있습니다.

Q. MCP 서버에 인증이 필요한가요?

A. 아니요. 아키스케치 API 문서는 공개되어 있어 별도 인증 없이 MCP 서버에 접근할 수 있습니다. 단, 실제 API 호출 시에는 x-api-key가 필요합니다.

Q. 어떤 AI 도구에서 사용할 수 있나요?

A. MCP를 지원하는 AI 도구라면 모두 사용 가능합니다. Claude Desktop, Cursor, VS Code, Claude Code 등에서 연결할 수 있습니다.

Q. MCP로 API를 직접 호출할 수 있나요?

A. 아니요. MCP는 API 문서 검색 기능만 제공합니다. 실제 API 호출은 기존과 동일하게 아키스케치 API 서버(https://openapi.archisketch.com)로 직접 요청합니다.

Q. 최신 문서가 반영되나요?

A. 네. MCP 서버는 항상 공개된 최신 버전의 문서를 제공합니다. 문서가 업데이트되면 MCP를 통한 검색 결과에도 즉시 반영됩니다.

Previous상품 등록하기Next변경이력

Last updated

Was this helpful?