PixAI Platform

문서 MCP 서버

Claude Code, Cursor, VS Code 등 MCP 클라이언트를 문서 MCP 서버(https://platform.pixai.art/docs-mcp)에 연결하면 AI 에이전트가 이 문서를 검색하고 읽을 수 있습니다. 이미지를 생성하지는 않습니다.

이 문서는 원격 Model Context Protocol 서버를 통해 AI 코딩 에이전트에서 사용할 수 있습니다. 연결하면 에이전트가 PixAI API를 사용하는 코드를 작성할 때 엔드포인트, 매개변수, 예제를 추측하지 않고 직접 찾아봅니다.

이 서버는 문서만 제공합니다. 이미지나 동영상을 생성하거나 PixAI API를 호출하지 않습니다. 그 일은 에이전트가 작성한 코드가 사용자의 API 키로 합니다.

  • URL: https://platform.pixai.art/docs-mcp
  • 전송 방식: Streamable HTTP
  • 인증: 필요 없으며, 크레딧도 사용하지 않습니다.

에디터나 에이전트에 연결하기

Claude Code

claude mcp add --transport http pixai-docs https://platform.pixai.art/docs-mcp

Cursor

~/.cursor/mcp.json 또는 프로젝트의 .cursor/mcp.json에 서버를 추가합니다.

{
  "mcpServers": {
    "pixai-docs": {
      "url": "https://platform.pixai.art/docs-mcp"
    }
  }
}

VS Code

프로젝트의 .vscode/mcp.json에 서버를 추가합니다.

{
  "servers": {
    "pixai-docs": {
      "type": "http",
      "url": "https://platform.pixai.art/docs-mcp"
    }
  }
}

기타 클라이언트

Streamable HTTP 원격 MCP 서버를 지원하는 클라이언트라면 위 URL로 연결할 수 있습니다. 로컬(stdio) 서버만 지원하는 클라이언트는 mcp-remote로 중계하세요.

{
  "mcpServers": {
    "pixai-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://platform.pixai.art/docs-mcp"]
    }
  }
}

도구

도구기능
search_docs모든 문서 페이지를 한국어, 영어, 일본어로 전문 검색하고, 일치하는 페이지와 섹션을 URL과 함께 반환합니다. 한국어로 검색할 때는 locale에 ko를 지정하세요.
read_doc한 페이지를 Markdown으로 반환합니다. API 레퍼런스 페이지는 요청과 응답 스키마도 포함합니다.
list_docs문서 목차(모든 페이지의 URL과 한 줄 설명, OpenAPI 사양 링크)를 반환합니다.

에이전트에게 이렇게 요청해 보세요: "pixai-docs MCP 서버를 사용해서 PixAI API로 이미지를 생성하고 다운로드하는 스크립트를 작성해 줘."

MCP 없이 AI 에이전트가 문서를 읽는 방법

같은 내용을 일반 HTTP로도 받을 수 있습니다.

  • /ko/llms.txt는 llms.txt 형식으로 모든 페이지를 짧은 설명과 함께 나열합니다. /llms-full.txt에는 모든 페이지의 본문이 한 파일로 들어 있습니다.
  • 모든 문서 페이지에는 Markdown 버전이 있습니다. URL 끝에 .md를 붙이거나(예: /ko/docs/faq.md) Accept: text/markdown 헤더로 요청하세요.
  • API v2의 OpenAPI 3.1 사양은 /openapi-spec.v2.ko.yaml에 있습니다.
  • 각 페이지 제목 아래의 Copy Markdown과 Open 버튼으로 페이지를 채팅에 붙여 넣거나 ChatGPT, Claude, Cursor에서 열 수 있습니다.