MCP 문서

MCP 문서 (MCP Docs)

Mintlify MCP Docs Server를 사용해 IDE에서 직접 AgentOps 문서와 채팅하는 방법을 소개해요. 설치 방법, 작동 방식, 그리고 일반적인 문제 해결까지 알아볼게요.

출처: 문서

본문

AgentOps API 도구를 찾고 있나요? 대신 MCP Server 가이드를 참조하세요.

MCP Docs Server

Mintlify MCP Docs Server는 여러분과 여러분의 코딩 에이전트에게 AgentOps 문서의 모든 페이지에 대한 즉각적이고 프로그래밍 방식의 접근을 제공합니다. Cursor, Windsurf, VS Code, Zed, Claude Code, 또는 Model Context Protocol을 지원하는 다른 어떤 도구에서도 동작합니다.

설치 (Installation)

npx mint-mcp add agentops

어떤 폴더에서든 위 명령을 실행하면 IDE가 문서 서버를 자동으로 등록합니다. 추가 설정이 필요 없습니다.

작동 방식 (How it works)

여러분(또는 에디터 안의 AI 어시스턴트)이 질문하면, IDE가 MCP Docs Server에 요청을 보냅니다. 서버는 AgentOps 문서를 검색해 가장 관련 있는 섹션을 반환하므로, 어시스턴트가 정확한 답변을 만들 수 있습니다.

예시 프롬프트 "How do I record custom spans with the @operation decorator?"

무엇을 물어볼 수 있나요? (What you can ask)

시작을 위한 몇 가지 아이디어입니다.

기능 추가 (Add features)

  • "Add a chat interface with streaming support to my app"
  • "Instrument my agent with the @trace decorator"

통합에 대해 물어보기 (Ask about integrations)

  • "How do I integrate AgentOps with the Vercel AI SDK?"
  • "Show me a working example for CrewAI"

기존 코드 디버그 또는 업데이트 (Debug or update existing code)

  • "My trace isn't showing spans—what could be wrong?"
  • "How do I customize the styling of the Session Waterfall?"

답변이 문서에 있다면, 서버가 그것을 찾을 거예요.

일반적인 문제 (Common issues)

서버가 시작되지 않음 (Server not starting)

  1. npx가 설치되어 동작하는지 확인하세요.
  2. 같은 포트에서 실행 중인 다른 MCP 서버가 있는지 확인하세요.
  3. 설정 파일 구문을 검증하세요.
  4. Windows에서는 Node.js와 npm이 설치되어 있는지 확인하세요.

도구 호출 실패 (Tool calls failing)

  1. MCP Docs Server 및/또는 IDE를 다시 시작하세요.
  2. IDE를 최신 버전으로 업데이트하세요.
  3. AgentOps 문서 서버가 IDE의 MCP 서버 목록에 나타나는지 확인하세요.

더 알아보기 (Learn more)