시작하기
MCP 서버
내장 MCP 서버를 사용해 AI 에이전트를 Tona 문서에 연결하세요.
Tona Docs에는 AI 에이전트가 문서를 직접 검색하고 읽을 수 있는 내장 MCP (Model Context Protocol) 서버가 포함되어 있습니다. Claude Code, Cursor, 기타 AI 기반 개발 환경을 사용할 때 특히 유용합니다.
엔드포인트
https://docs.tona.app/mcp서버는 POST 를 통해 JSON-RPC 2.0 요청을 받습니다.
사용 가능한 도구
MCP 서버는 세 가지 도구를 제공합니다.
| Tool | Description |
|---|---|
list_docs | 섹션별로 정리된 모든 문서 페이지를 나열합니다 |
read_doc | 경로로 특정 페이지를 읽습니다 (예: getting-started/creating-a-project) |
search_docs | 모든 문서 페이지를 전체 텍스트 검색합니다 |
설정
Claude Code
프로젝트의 .mcp.json 에 다음 내용을 추가합니다.
{
"mcpServers": {
"tona-docs": {
"type": "url",
"url": "https://docs.tona.app/mcp"
}
}
}Cursor
프로젝트의 .cursor/mcp.json 에 다음 내용을 추가합니다.
{
"mcpServers": {
"tona-docs": {
"type": "url",
"url": "https://docs.tona.app/mcp"
}
}
}기타 MCP 클라이언트
Streamable HTTP transport를 사용해 MCP 호환 클라이언트를 https://docs.tona.app/mcp 에 연결하세요. 서버는 단일 요청과 배치 JSON-RPC 요청을 모두 지원합니다.
연결 확인
브라우저에서 아래 엔드포인트를 열면 서버가 동작 중인지 확인할 수 있습니다.
https://docs.tona.app/mcp서버 이름, 버전, 사용 가능한 도구가 포함된 JSON 응답이 반환됩니다.