원격 MCP 연동 검수: 디스커버리로 증명되는 것과 아직 검증해야 할 것

제품 상태 업데이트(2026-10-09 베이징 시간 기준 확인): 이 글의 도구 6개 목록은 2026-09-04에 관찰한 과거 기록입니다. everyinfra_chat은 2026-09-12에 범용 텍스트 API와 함께 중단되었다가 AI API와 함께 다시 제공되고 있습니다(충전 후 무료, 스트리밍 미지원). 데이터 정리 도구는 지원이 종료되었습니다. 현재 도구 목록은 항상 실시간 MCP 디스커버리(tools/list)로 확인하십시오.

클라이언트에 MCP 주소를 입력하고 도구 이름이 나타나는 것을 확인했다면 의미 있는 진전입니다. 하지만 키가 올바르게 전달되는지, 실제 호출이 허용된 범위 안에 있는지, 클라이언트가 오류를 인식하는지, 반환된 데이터가 작업 요구 사항을 충족하는지는 아직 알 수 없습니다.

이 문서는 EveryInfra의 원격 엔드포인트를 예로 들어 연동 검수를 프로토콜 디스커버리, 인증 매칭, 클라이언트 동작, 비즈니스 결과의 네 계층으로 나눕니다. 먼저 키 없는 디스커버리 프로브를 제공하고, 이어서 "주소만 입력하면 된다"는 설명을 세 클라이언트에 똑같이 적용할 수 없는 이유를 설명합니다. 이 글은 테스트한 범위를 명시한 연동 가이드이며, Claude, ChatGPT, Cursor에 모두 성공적으로 설치되었다는 선언이 아닙니다.

원격 주소 하나와 서로 독립된 네 가지 근거 계층

여기서 확인한 진입점은 https://api.everyinfra.com/mcp입니다. 프로토콜 디스커버리는 서버가 자신을 어떻게 설명하고 어떤 도구를 노출하는지 알려 줍니다. 인증 매칭은 클라이언트가 승인된 자격 증명을 어떻게 얻고 전달하는지를 다룹니다. 클라이언트 검수는 도구가 실제로 현재 세션에서 사용 가능해지는지 확인하고, 비즈니스 검수는 실제 결과와 오류를 검증합니다.

네 계층은 따로 기록해야 합니다. 서버가 초기화에 응답했다고 클라이언트가 이후 알림을 수락했다는 뜻은 아닙니다. 클라이언트가 카탈로그를 볼 수 있다고 비즈니스 권한이 있다는 뜻도 아니며, 도구가 콘텐츠를 반환했다고 비즈니스 오류가 없다는 뜻도 아닙니다. '연결 성공'이라는 불리언 값 하나로 모든 경우를 덮어서는 안 됩니다.

마찬가지로 MCP와 REST는 서로 다른 연동 방식입니다. REST 샘플은 비즈니스 의미를 검증하는 데 도움이 되지만, 클라이언트가 MCP 인증, 콘텐츠 블록, 오류, 확인 절차를 올바르게 처리한다는 것을 단독으로 증명하지는 못합니다.

초기화 후에는 알림도 보내야 합니다

이 글은 MCP 2025-06-18 버전을 기준으로 이 디스커버리 경로를 확인하며, 이 버전이 모든 클라이언트에 대해 최신이거나 유일한 버전이라고 주장하지 않습니다. 클라이언트는 먼저 initialize를 보내 서버가 선택한 버전을 확인하고, 이어서 notifications/initialized를 보낸 다음에야 도구 디스커버리로 넘어갑니다. 이후 HTTP 요청에는 협상된 프로토콜 버전을 포함해야 합니다. 프로토콜 라이프사이클

Streamable HTTP 알림이 수락되면 응답 본문 없이 HTTP 202를 반환해야 합니다. 서버가 초기화 중에 Mcp-Session-Id를 반환하면 클라이언트는 이후 요청에서 이 값을 유지해야 하며, 이 응답 헤더 없이 세션을 임의로 만들어 낼 수는 없습니다. 요청에 대한 응답은 JSON 또는 SSE일 수 있으며, 실제 클라이언트는 프로토콜이 요구하는 전송 형식을 지원해야 합니다. 전송 사양

아래 스크립트는 이 서버가 사용하는 JSON 응답 분기만 확인하며, 범용 MCP 클라이언트가 아닙니다. SSE, 페이지네이션된 카탈로그, 지원하지 않는 버전을 만나면 중단하고 이후 검수는 완전한 기능을 갖춘 클라이언트에 맡깁니다. JSON 객체 하나를 파싱했다고 해서 프로토콜 전체를 다룬 것처럼 보이게 하지 않습니다.

디스커버리 전용 진단 스크립트

내장 fetch를 지원하는 Node.js 22 이상을 사용하십시오. 이 스크립트는 환경에서 키를 읽지 않고, tools/call을 보내지 않으며, 어떤 클라이언트도 설치하거나 수정하지 않습니다. 출력에는 상태, 도구 이름, 호환성 문제만 남기며, 서버 설명에 담긴 홍보 문구는 출력하지 않습니다.

node --input-type=module <<'JS'
const endpoint = 'https://api.everyinfra.com/mcp';
const supportedVersion = '2025-06-18';
const headers = {
  'Content-Type': 'application/json',
  Accept: 'application/json, text/event-stream',
};
const issues = [];
async function post(message) {
  const response = await fetch(endpoint, {
    method: 'POST', headers, redirect: 'error',
    body: JSON.stringify(message),
    signal: AbortSignal.timeout(20000),
  });
  return { response, text: await response.text() };
}
function rpcResult(reply, id) {
  if (reply.response.status !== 200) {
    throw new Error('RPC HTTP ' + reply.response.status);
  }
  if (!reply.response.headers.get('content-type')?.includes('application/json')) {
    throw new Error('This probe only handles JSON; use a full MCP client');
  }
  const body = JSON.parse(reply.text);
  if (body.jsonrpc !== '2.0' || body.id !== id ||
      body.error || !body.result || typeof body.result !== 'object') {
    throw new Error('Invalid or failed RPC response');
  }
  return body.result;
}
const initReply = await post({
  jsonrpc: '2.0', id: 1, method: 'initialize',
  params: {
    protocolVersion: supportedVersion, capabilities: {},
    clientInfo: { name: 'bip-discovery-only', version: '1.0' },
  },
});
const init = rpcResult(initReply, 1);
if (init.protocolVersion !== supportedVersion ||
    init.serverInfo?.name !== 'EveryInfra' || !init.capabilities?.tools) {
  throw new Error('Unexpected version, server or tool capability');
}
headers['MCP-Protocol-Version'] = init.protocolVersion;
const session = initReply.response.headers.get('mcp-session-id');
if (session) headers['Mcp-Session-Id'] = session;
const notification = await post({
  jsonrpc: '2.0', method: 'notifications/initialized',
});
if (notification.response.status !== 202) {
  throw new Error('Initialization notification was not accepted');
}
const notificationBytes = Buffer.byteLength(notification.text);
if (notificationBytes !== 0) issues.push('notification_body_not_empty');
// Continue discovery for diagnosis only; never enter a business call.
const listed = rpcResult(await post({
  jsonrpc: '2.0', id: 2, method: 'tools/list', params: {},
}), 2);
if (!Array.isArray(listed.tools) || listed.tools.length === 0 ||
    listed.tools.some(tool => !tool.name || tool.inputSchema?.type !== 'object') ||
    listed.nextCursor) {
  throw new Error('Incomplete or unexpected tool list');
}
console.log(JSON.stringify({
  observedAt: new Date().toISOString(),
  protocolVersion: init.protocolVersion,
  sessionHeaderPresent: Boolean(session),
  notificationStatus: notification.response.status,
  notificationBodyBytes: notificationBytes,
  toolNames: listed.tools.map(tool => tool.name),
  issues,
  businessCallPerformed: false,
  hostAcceptanceVerified: false,
}, null, 2));
if (issues.length) process.exitCode = 2;
JS

종료 코드 0은 이 제한된 디스커버리 검사에서 불일치를 발견하지 못했다는 뜻일 뿐이며, 게시해도 된다거나 세 클라이언트의 검수에 성공했다는 의미는 결코 아닙니다. 종료 코드 2는 카탈로그는 가져왔지만 프로토콜 불일치가 있다는 뜻이며, 그 밖의 오류는 실행을 종료합니다. 연결 실패와 디스커버리 성공 후의 호환성 문제는 따로 처리해야 합니다.

이번 디스커버리에서 성공한 것과 발견한 문제

2026년 9월 4일 20:43(중국 표준시)에 인증 없이 재확인한 결과, 초기화는 HTTP 200과 프로토콜 버전 2025-06-18을 반환했으며 세션 ID 응답 헤더는 제공하지 않았습니다. 도구 카탈로그는 다음 6개 이름을 반환했습니다:

• everyinfra_list_capabilities
• everyinfra_call_api
• everyinfra_chat
• everyinfra_list_captcha_types
• everyinfra_solve_captcha
• everyinfra_search

그러나 초기화 완료 알림이 HTTP 202를 반환했을 때 응답 본문은 비어 있지 않고 JSON null이었습니다. 이는 앞서 언급한 버전의 알림 응답 요구 사항을 충족하지 않습니다. 카탈로그는 여전히 읽을 수 있지만, 그것만으로 모든 클라이언트가 이 불일치를 허용한다고 증명할 수는 없습니다. 스크립트는 이를 조용히 무시하지 말고 명시적으로 보고해야 합니다.

이번 회차에서는 비즈니스 도구를 호출하지 않았으며, 이 불일치 때문에 클라이언트가 실패하는지도 확인하지 않았습니다. 이후의 응답 불일치는 서비스 관리자가 처리하고 실제 클라이언트에서 다시 테스트해야 합니다. 현재 근거로 뒷받침되는 진술은 "공개 디스커버리 경로에서 도구 6개와 알림 응답 불일치를 관찰했다"이며, 이를 "MCP와 완전히 호환된다"고 쓸 수는 없습니다.

2026년 9월 8일에 같은 무료 디스커버리 과정을 다시 실행했을 때 카탈로그는 도구 8개를 반환했으며, 새로 추가된 두 항목은 데이터 정리 도구였습니다. 초기화 완료 알림은 HTTP 202에 응답 본문 0바이트였으므로, 9월 4일의 응답 불일치는 이번 재확인에서 재현되지 않았습니다. 이 업데이트도 공개 디스커버리 계층의 이전 관찰을 마무리한 것일 뿐이며, Claude, ChatGPT, Cursor에서 인증이나 실제 비즈니스 호출을 마쳤다는 의미는 아닙니다.

Cursor: 설정 헤더 지원과 실제 권한은 따로 검증하기

Cursor 공식 문서에서는 원격 서버용 url 및 headers 설정을 제공하며, 환경 변수 보간을 지원합니다. 아래는 사용자 승인 후 사용할 설정 형태입니다. 이번 회차에서는 이를 사용자 설정에 기록하거나 실제 클라이언트 호출을 검증하지 않았습니다. Cursor MCP 문서

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}"
      }
    }
  }
}

현재 프로젝트의 서버 코드에는 Bearer 헤더 파싱이 포함되어 있지만, 소스 코드에 이 경로가 있다고 해서 특정 키를 지금 사용할 수 있다는 증거는 아닙니다. 실제 연동을 준비할 때는 클라이언트 프로세스가 지정된 환경 변수를 읽을 수 있는지 확인하고 키의 비즈니스 권한을 검증하십시오. 실제 값을 버전 관리되는 설정, 스크린샷, 오류 보고서에 쓰지 마십시오.

그다음 현재 버전의 Cursor에서 카탈로그를 새로 고치고, 도구를 개별적으로 선택하며, 사용자 확인 절차를 유지하십시오. 카탈로그가 보인다고 모든 도구의 자동 실행을 켜서는 안 되며, 비즈니스 권한이 있는 키를 모든 작업에 대한 장기 승인으로 취급해서도 안 됩니다.

Claude: 원격 커넥터는 로컬 네트워크를 거치지 않습니다

Claude 공식 원격 커넥터 문서에 따르면, Claude Desktop의 원격 커넥터를 포함해 요청은 Anthropic 클라우드에서 발생합니다. 이는 데스크톱 로컬 설정의 로컬 MCP 구성과는 다른 메커니즘입니다. 따라서 로컬에서 주소에 접근할 수 있다는 것은 로컬 경로만 증명할 뿐, 클라우드 커넥터도 접근할 수 있다는 증거는 아닙니다. Claude 원격 커넥터 안내

연동할 때는 현재 계정과 조직 권한에 따라 커넥터 진입점을 확인한 뒤, 서비스와 클라이언트가 모두 지원하는 인증 흐름을 검증해야 합니다. 공식 문서의 OAuth 설정을 "어떤 Bearer API 키든 입력할 수 있다"로 바꿔 쓸 수는 없습니다. 인증 모델이 맞지 않으면 서비스 또는 통제된 어댑터 방안을 먼저 설계하고 승인받아야 하며, 범용 대안으로 비밀 값을 URL에 넣어서는 안 됩니다.

이 계정으로 검증하지 않은 클릭 과정을 보여 주는 스크린샷이나 "추가하면 성공" 같은 절차는 여기서 제공하지 않습니다. 커넥터 추가, 권한 부여, 최종 확인은 계정 상태를 바꾸므로 사용자의 동의를 받은 후 실행해야 하며, 프로토콜 프로브가 이런 근거를 대신할 수 없습니다.

ChatGPT와 OpenAI API: 서로 다른 두 연동 진입점

ChatGPT 플러그인 MCP 인증 공식 문서에는 OAuth, 인증 없음, 하이브리드 인증이 나열되어 있습니다. 하이브리드 인증은 인증 없이 디스커버리를 수행하고, 도구별 보안 선언에 따라 인증 방식을 선택하는 방식입니다. 디스커버리에 키가 필요 없다고 해서 모든 비즈니스 도구를 인증 없이 호출할 수 있다는 뜻은 아닙니다. ChatGPT Developer mode

이번 도구 카탈로그에서는 도구 수준의 securitySchemes 또는 _meta 필드가 관찰되지 않았습니다. 이는 이번 응답에 대한 관찰일 뿐 서비스 전체 인증 구현에 대한 완전한 감사는 아닙니다. 하지만 디스커버리 성공만으로 ChatGPT 하이브리드 인증 요구 사항을 충족한다고 주장할 수 없음을 보여 주기에는 충분합니다.

OpenAI Responses API의 원격 MCP 설정은 또 다른 경로로, server_url, 도구 선택, 인증, 호출 승인 같은 파라미터를 포함합니다. 이는 ChatGPT 인터페이스 안의 설정 방법이 아니며, API로 요청을 구성했다고 해서 웹 인터페이스까지 연결되었다는 증거가 되지는 않습니다. OpenAI MCP 및 커넥터 가이드

이번 회차에서는 문서만 확인했으며, OpenAI API 비즈니스 요청을 실행하거나 사용자를 위해 Developer mode를 켜지 않았습니다. 이후 이 경로를 사용한다면 원격 서비스로 전송되는 데이터 범위를 별도로 검토하고, 민감한 호출에 대한 승인 단계를 유지해야 합니다.

인증 설계 시에는 공식 MCP 보안 모범 사례 튜토리얼도 별도로 검토해야 합니다. 2025-11-25 문서 경로에 있는 이 페이지는 토큰이 올바른 서비스를 대상으로 해야 한다고 설명하며, 검증되지 않은 토큰 패스스루에 반대합니다. 다만 이 페이지가 서드파티 키를 범용 MCP 자격 증명으로 만들어 주지는 않으며, 앞에서 2025-06-18 버전을 기준으로 수행한 디스커버리 검사를 대체하지도 않습니다.

HTTP 200 이후에도 확인해야 할 결과 계층이 두 개 더 있습니다

MCP의 프로토콜 오류는 최상위 JSON-RPC error에 나타날 수 있고, 도구 실행 오류는 result.isError로 표현될 수도 있습니다. HTTP 200이나 텍스트 블록이 있다는 사실만으로 비즈니스 성공을 선언하기에는 부족합니다. 도구 및 오류 사양

실제 운영에서는 도구가 반환한 데이터 구조도 점검해야 합니다. 출력이 기대한 객체와 일치하는지, 비어 있거나 일부만 완료되었는지, 비동기 작업이라 아직 조회가 필요한지를 확인합니다. 여러 콘텐츠 블록은 각 도구가 문서화한 응답에 따라 처리해야 하며, 첫 번째 텍스트 블록에 모든 메타데이터가 있다고 가정해서는 안 됩니다. 과금, 사용량, 잔액은 실제 비즈니스 응답에서 확인해야 하며, 카탈로그를 조회했다고 비즈니스 호출의 정산이 증명되지는 않습니다.

전송, 구매, 제출 등 부수 효과가 있는 작업의 경우, 클라이언트에 도구가 표시된다고 해서 사용자가 실행을 승인한 것은 아닙니다. 호출 전에 대상과 파라미터를 확인하고, 재시도 전에는 첫 시도의 결과가 확인되었는지 판단하십시오. 이 문서의 키 없는 프로브는 의도적으로 이 계층에 들어가지 않습니다.

다음 연동 담당자에게 넘겨줄 검수 기록

클라이언트마다 제품과 버전, 실행 위치, 전송 및 인증 방식, 설치·승인 근거, 실제 도구 이름, 비식별 처리한 입력, 결과 상태, 오류를 따로 기록해야 합니다. 관찰 시각과 허용된 호출 범위는 기록하되 원본 키는 저장하지 마십시오. 성공 샘플, 명시적 실패, 결과 미확인은 각각 따로 문서화해야 합니다.

기록 방식은 OWASP 로깅 가이드의 이벤트 상관관계 및 데이터 제외 원칙을 참고할 수 있습니다. 개별 작업을 서로 연결할 수 있게 하되, 토큰, 세션, 고객 콘텐츠 전체를 디버깅 첨부 파일에 기록하지 않도록 합니다. 로그는 검수 근거의 일부일 뿐이며, 실제 클라이언트 동작 확인을 대신하지 않습니다.

이번 회차에 완료한 것은 공개 디스커버리와 문서 불일치 검증입니다. 알림 빈 본문 수정, 세 클라이언트의 설치 및 인증, 승인된 비즈니스 호출, 실패 표시 검수는 아직 완료되지 않았습니다. 각 항목에 대한 근거가 확보되어야 튜토리얼 표현을 "검증 대기 중인 설정"에서 "특정 버전에서 테스트 통과"로 바꿀 수 있습니다.

먼저 이 글의 디스커버리 스크립트를 실행해 현재 인터페이스와 기록이 여전히 일치하는지 확인한 뒤, 팀이 선택한 클라이언트에 맞춰 진행하십시오. 호환성 목록을 채우려고 세 계정을 동시에 수정하거나 검증되지 않은 설정을 복사하지 마십시오. EveryInfra 문서 바로가기