문서 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-mcpCursor
~/.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에서 열 수 있습니다.