Cloudflare 원격 MCP 서버는 호환되는 AI 클라이언트에 선택한 도구의 호스팅 인터페이스를 제공합니다. 엔드포인트를 온라인으로 만드는 것은 쉬운 이정표입니다. 정말 유용한 이정표는 클라이언트가 올바른 사용자 권한으로 의도한 업무를 완료하고, 운영팀이 그 결과를 설명할 수 있는 상태입니다.
Cloudflare에서 원격 MCP 서버를 만들 때는 좁은 도구 계약, 인증된 신원, 명시적인 하위 시스템 권한을 중심에 두세요. 지원할 클라이언트에서 도구 발견, 인가, 실행, 복구를 시험해야 합니다. MCP 엔드포인트에 접속된다는 사실은 업무 기록을 다룰 준비가 됐다는 증거가 아닙니다.
기존 시스템에서 주문을 조회하는 직원 도우미를 생각해 보세요. 첫 버전은 주문 상태만 읽습니다. 다음 버전에서는 주소 변경을 제안할 수 있습니다. 둘 다 같은 클라이언트에 도구로 보여도 필요한 권한과 실패의 결과는 다릅니다.
이 안내는 호스팅 구현의 경계를 다룹니다. 앞선 구매 판단은 당사의 MCP 서버 개발 안내 를 참고하세요. 여기의 예시는 설계 제안이며, 배포된 고객 시스템에 관한 주장은 아닙니다.
Cloudflare 원격 MCP 서버 계약 정의하기
Cloudflare는 원격 MCP 서버 안내 를 유지합니다. 현재 안내를 배포 출발점으로 삼고 선택한 의존성을 고정하며 지원하는 전송 방식과 클라이언트를 기록하세요. 결과를 검증하지 않은 채 서로 다른 SDK 세대의 코드 조각을 섞지 마세요.
유용한 도구 이름은 허용되는 업무 작업을 설명합니다. 주문 조회 입력은 주문과 실제로 필요한 맥락을 식별해야 합니다. 서버를 일반화한다는 이유만으로 사용자가 고른 데이터베이스, 임의 쿼리, 하위 시스템 URL을 받지 마세요.
출력은 조회 완료, 원본 이용 불가, 작업 거부를 구분해야 합니다. 모든 실패에 빈 객체를 반환하면 도우미가 설명을 만들어 낼 수 있습니다. 내부 자격 증명이나 무관한 기록을 노출하지 않으면서 클라이언트가 정확히 보여 줄 수 있는 제한된 결과를 반환하세요.
| 계약 요소 | 주문 조회 예시 | 명시하는 이유 |
|---|---|---|
| 입력 | 주문 번호 | 조회 범위 제한 |
| 권한 | 인증된 직원과 계정 범위 | 다른 계정 읽기 방지 |
| 결과 | 상태, 원본 관찰 시각, 허용 맥락 | 답변 해석 가능 |
| 거부 | 안전하고 명시적인 결과 | 거부된 기록을 없다고 오해하지 않음 |
| 추적 | 내용을 드러내지 않는 작업 번호 | 기록을 복사하지 않고 조사 지원 |
호출자 신원과 서비스 자격 증명 분리하기
호스팅 서버는 주문 API용 자격 증명이 필요할 수 있습니다. 이 서비스 자격 증명은 호출자의 신원이 아닙니다. 강력한 하위 시스템 자격 증명을 쓰더라도 현재 호출자가 어떤 기록을 요청할 수 있는지 서버가 집행해야 합니다.
Cloudflare의 MCP 인가 문서 는 원격 연결의 인가 계층을 설명합니다. 한 경로가 받아들인 토큰이 모든 목적지에 적절하다고 가정하지 말고, 대상 클라이언트의 로그인과 토큰 흐름을 직접 확인하세요.
고객 또는 조직 범위는 신뢰할 수 있는 세션 정보로 결정하세요. customer_id 같은 도구 인자가 그 범위와 대조되지 않은 채 접근을 넓히게 해서는 안 됩니다. 모델이 직원을 관리자라고 주장해도 그것은 인가 결정이 아닙니다.
작업이 실행될 때 접근 권한을 다시 확인하세요. 이전에 발견한 도구라도 역할 변경이나 철회 뒤에는 허용되지 않을 수 있습니다. 권한을 없앴을 때 기존 연결과 새 연결에 어떤 일이 생기는지 기록해야 합니다.
배포 설정과 도구 정책 분리하기
개발과 운영 설정을 의도적으로 유지하세요. 각 환경을 올바른 하위 시스템에 연결하고 비밀을 소스 파일, 프롬프트, 도구 설명에 넣지 마세요. 복사한 설정에 잘못된 엔드포인트가 남았다는 이유로 테스트 클라이언트가 운영 권한을 얻어서는 안 됩니다.
소스 버전, 의존성 잠금, 환경, 설정 변경을 식별하는 배포 기록을 사용하세요. 새 도구 설명 때문에 클라이언트가 예상치 못한 작업을 선택하면, 팀은 정확히 무엇이 바뀌었는지 알아야 합니다.
도구 설명은 제품 인터페이스의 일부입니다. 무엇을 하는지, 결과가 무엇을 뜻하는지, 무엇을 확정할 수 없는지 설명하세요. 반환된 제삼자 텍스트를 무관한 호출 권한으로 취급하라고 모델에 지시하지 마세요.
주문 서버에서는 조회와 변경을 별도 기능으로 유지하세요. 선택 인자에 따라 읽기에서 쓰기로 바뀌는 넓은 도구는 검토와 접근 제어를 어렵게 합니다. 명시적인 작업은 호환성 시험도 더 쉽게 해석하게 해 줍니다.
실제 클라이언트 여정 시험하기
Cloudflare는 원격 서버 클라이언트 시험 을 문서화합니다. 프로토콜 검사기는 유용하지만 운영 클라이언트에는 자체 발견, 인가, 표시 동작이 있습니다. 지원 약속에 이름을 적은 모든 클라이언트를 포함하세요.
새 연결에서 시작하는 보통의 여정을 시험하세요. 이어서 만료 세션, 철회된 권한, 원본 이용 불가, 잘못된 도구 입력을 시험해야 합니다. 서버에 기록된 것뿐 아니라 사용자에게 보이는 것도 관찰하세요.
| 시험 사례 | 기대 애플리케이션 결과 | 증거 |
|---|---|---|
| 허용된 조회 | 올바른 주문 맥락 반환 | 호출자 범위와 원본 결과 |
| 다른 계정의 주문 | 접근 거부 | 미인가 기록 내용 없음 |
| 원본 타임아웃 | 가용성 실패 설명 | 작업 번호와 실패 단계 |
| 권한이 철회된 호출자 | 추가 사용 거부 | 기존 및 새 연결 결과 |
| 잘못된 입력 | 하위 작업 전 검증 실패 | 원본 요청 없는 거부 |
이 시험에서는 구별하기 쉬운 라벨의 합성 기록을 사용하세요. 데이터가 너무 비슷하면 다른 계정 결과도 그럴듯해 보여 검토를 피할 수 있습니다. 서버를 작성하지 않은 사람도 권한 실패를 분명히 알아볼 수 있는 인수 보고서를 만들어야 합니다.
도구 성공과 업무 성공 구분하기
MCP 통신이 성공해도 오래된 주문 상태나 하위 시스템의 거부를 반환할 수 있습니다. 성공은 원본 시스템과 직원의 업무를 기준으로 정의하세요. 도구가 예외 없이 반환됐다는 이유만으로 변경이 끝났다고 말하면 안 됩니다.
나중에 주소 변경 도구를 추가한다면 목적지의 작업 번호와 변경 뒤 기록 상태를 보관하세요. 응답이 사라지면 다시 제출하기 전에 그 번호를 조사해야 합니다. 전송 재시도와 안전한 업무 반복은 서로 다른 질문입니다.
쓰기 도구 추가 전에 복구 계획하기
읽기 전용 접근으로 유용한 결과를 얻을 수 있다면 거기서 시작하세요. 초기 복구 범위를 줄이고, 중요한 업무 처리를 도입하기 전에 신원과 도구 선택을 검증할 수 있습니다.
쓰기에는 승인, 만료, 중복 처리, 불확실한 결과의 규칙을 명시하세요. 승인은 실제 변경안과 대상 기록을 가리켜야 합니다. 모호한 지시에 대한 사용자 승인이 나중에 실질적으로 달라진 작업의 권한이 돼서는 안 됩니다.
도구를 비활성화하더라도 이미 제출된 작업을 대조할 증거는 잃지 않는 방법을 유지하세요. 발견 목록에서 작업을 없앴다고 해서 이전에 수락한 작업이 멈췄다고 확인되지는 않습니다.
개발과 지원 비용을 결정하는 요소
주요 비용 요인은 하위 API 품질, 신원 매핑, 클라이언트 종류, 각 작업의 결과입니다. 문서화된 API에 대한 읽기 전용 조회와 여러 시스템의 변경을 조율하는 통합은 서로 다른 프로젝트입니다.
프로토콜 준비, 인가, 도구 구현, 인수, 운영 인계를 분리한 GBP 제안을 요청하세요. 어떤 환경과 클라이언트가 포함되는지도 물어봐야 합니다. 호환성이나 하위 장애를 제외한 낮은 견적은 전체 통합 제안과 비교할 수 없습니다.
| 작업 영역 | 인수 산출물 | 흔한 추가 작업 원인 |
|---|---|---|
| 신원 | 호출자와 기록 간 권한 시험 | 시스템마다 다른 역할 |
| 도구 설계 | 안정적이고 검증된 입력과 결과 | 문서 없는 하위 동작 의미 |
| 클라이언트 지원 | 지정 클라이언트 여정 기록 | 서로 다른 전송 또는 로그인 |
| 복구 | 연습한 결과 불확실 처리 절차 | 목적지 작업 번호 없음 |
| 유지보수 | 책임과 업그레이드 과정 | 고정되지 않은 의존성 또는 테스트 환경 부재 |
호스팅 사용료는 예산의 한 항목일 뿐입니다. 로그, 상위 API 사용, 모니터링, 의존성 유지, 지원을 포함하세요. 반복 요금을 추정하기 전에 선택 부하의 현재 공급업체 요금을 확인해야 합니다. 도구 개수만으로 사용 비용을 알 수는 없습니다.
다른 사람이 운영할 수 있는 엔드포인트 발주하기
인계 후 다른 엔지니어가 서버를 배포하고 테스트 자격 증명을 교체하며 접근 거부를 재현하고 실패 조회를 추적할 수 있어야 합니다. 지원 클라이언트 목록, 의존성 잠금, 잘못된 도구 결과를 신고하는 경로도 포함하세요.
업무 시스템 책임자는 각 작업의 의미를 승인해야 합니다. 배포 책임자는 복구와 변경 과정을 승인해야 합니다. 이들을 일찍 모으면 엔드포인트는 기술적으로 완성됐지만 실제 동작은 아무도 책임지지 않는 상황을 막을 수 있습니다.
당사의 AI 통합 파일럿 으로 제한된 서버 범위를 정할 수 있습니다. 원본 API, 대상 클라이언트, 예시 업무, 접근 규칙을 준비하세요. 단순한 엔드포인트 시연이 아니라 신원, 인수, 인계를 포함하는 MCP 배포 제안 요청 을 보내 주세요.
자주 묻는 질문
어떤 점에서 MCP 서버가 원격인가요? 사용자의 로컬 클라이언트와 별도로 호스팅되며 지원하는 원격 연결로 접근합니다. 전송 지원, 인증, 호스팅 서비스가 연결된 업무 시스템에 도달하는 방법이 중요한 구현 질문입니다.
Cloudflare에 배포하면 도구가 자동으로 안전해지나요? 아닙니다. 앱은 여전히 입력을 검증하고 호출자 신원을 확립하며 하위 권한을 적용하고 도구 권한을 제어해야 합니다. 호스팅은 어떤 직원이 업무 기록을 읽거나 바꿀 수 있는지 결정하지 않습니다.
하나의 서버가 여러 AI 클라이언트를 지원할 수 있나요? 그렇게 설계할 수 있지만 각 지정 클라이언트를 시험해야 합니다. 발견, 인가, 표시 동작이 다를 수 있습니다. 지원 약속에는 검증한 클라이언트와 설정을 명시해야 합니다.
첫 버전에 쓰기 도구를 넣어야 하나요? 첫 번째 유용한 작업에 쓰기가 꼭 필요하고 승인과 복구 규칙이 명확한 경우에만 넣으세요. 읽기 전용 작업은 신원과 원본 통합을 검증하는 실용적인 출발점인 경우가 많습니다.
쓰기 타임아웃 뒤에는 어떻게 해야 하나요? 작업 번호를 유지하고 요청을 반복하기 전에 목적지를 확인하세요. 응답은 사라졌어도 변경은 완료됐을 수 있습니다. 결과를 확인할 수 없다면 지정된 운영자에게 넘겨야 합니다.
MCP 인계에는 무엇이 필요한가요? 소스, 의존성 잠금, 환경 설정, 도구 계약, 클라이언트 인수 결과, 자격 증명 책임자, 복구 절차서를 포함하세요. 다른 엔지니어가 성공한 업무와 거부된 작업을 모두 재현할 수 있어야 합니다.
구현 비용은 어떻게 추정하나요? 하위 시스템, 신원 매핑, 지정 클라이언트, 작업을 먼저 정의하세요. 조사, 구현, 인수, 지원을 분리한 GBP 범위를 요청해야 합니다. 도구당 가격은 권한과 불확실한 업무 결과의 복잡성을 가립니다.