ARCHIVE
AI INDEX
AI 개발·에이전트·자동화에서 반복되는 오류와 구현 문제를 증상 → 원인 → 검증 → 수정 순서로 정리한 기술 레퍼런스. 검색엔진과 AI 에이전트가 빠르게 파싱하고 인용할 수 있도록 검증된 정보와 적용 범위를 우선합니다.
-
MCP 호출은 응답했는데 작업이 실패했을 때: isError와 JSON-RPC error 구분
MCP 응답의 최상위 error, result.isError, resultType을 구분하고 재시도 전에 실제 대상 상태를 확인하는 진단 순서.
-
MCP 도구 목록이 일부만 보일 때: nextCursor 페이지네이션 확인
MCP tools/list의 첫 페이지를 전체 목록으로 오인하지 않도록 nextCursor와 후속 요청을 점검한다. 빈 문자열 커서, 최신 요청 메타데이터, 페이지 캐시와 미완료 판정을 다룬다.
-
MCP stdio JSON 파싱 오류: stdout 로그와 프로토콜 응답 분리
MCP stdio에서 JSON 파싱 오류가 발생할 때 stdout 로그 혼입과 줄 단위 프레이밍을 확인하는 절차. stderr 분리 예제와 검증 한계를 MCP 2026-07-28 기준으로 정리했다.
-
ChatGPT에서 MCP OAuth 로그인 창이 안 뜰 때: securitySchemes와 mcp/www_authenticate 확인
ChatGPT 원격 MCP의 OAuth 로그인 안내가 나타나지 않을 때 도구 인증 조건, 실행 오류 challenge, discovery 문서와 갱신 절차를 구분해 점검하는 개발자 가이드.
-
MCP outputSchema 검증 오류: structuredContent가 일치하는지 확인하는 법
MCP outputSchema 추가 뒤 도구 결과 검증이 실패한다면 실제 structuredContent부터 대조한다. 최소 JSON 예제, 타입·필수 필드 진단표, 미들웨어 경계 확인, MCP 2026-07-28과 OpenAI Plugins의 적용 범위를 정리했다.
-
MCP 2026-07-28로 바뀌면 initialize가 왜 안 보일까: 세션 없는 discovery 모델 이해하기
MCP 2026-07-28 revision에서는 기존 initialize/initialized handshake와 session 가정이 달라졌다. 2025-11-25 클라이언트와 혼용할 때 무엇을 봐야 하는지 정리한다.
-
Railway에 MCP 서버를 배포했는데 외부에서 연결되지 않을 때: PORT·/mcp·Public Domain 확인
Railway 배포가 성공해도 원격 MCP가 접근 가능한 것은 아니다. PORT 바인딩, public domain, /mcp Streamable HTTP endpoint, healthcheck를 분리해 확인한다.
-
ChatGPT 앱은 Connected인데 사용할 수 없을 때: 연결·가용성·권한을 분리해서 확인하기
ChatGPT 앱이 Connected로 표시돼도 현재 채팅, 모델, 워크스페이스, 권한 또는 지원 액션 때문에 사용할 수 없을 수 있다. 연결과 실행 가능성을 분리하는 진단표.