| 서버 | 실행 방식 | 도구 | 예약 필요 사항 | 견적 유효 기간 | 범위 |
Warp warp-agent-mcp | npx를 통한 stdio | ~23개 | API 키 | ~72시간 | 도로, 자체 네트워크 |
| CargoAi CargoMART | 호스팅 | 검색, 견적, 예약 | 계정 인증 | 단기 | 항공 화물 |
| freightutils-mcp | npx를 통한 stdio | ~19개 | 없음 (읽기 전용) | 해당 없음 | 계산, 참조 |
| Easyship | 호스팅 또는 stdio | 요금, 라벨, 추적 | API 키 | 운송업체별 상이 | 소포 |
몇 달 전, Model Context Protocol이 화물 API에 어떻게 적용되는지에 대한 입문서와 함께 직접 실행할 수 있는 최소한의 서버를 소개했습니다. MCP는 Anthropic이 2024년 11월에 발표한 개방형 표준이며, 화물 업계는 2026년 초까지 채택이 더뎠습니다. 그 이후로 논의는 멈추고 실제 운영이 시작되었습니다. Warp는 2026년 4월 16일 MIT 라이선스로 npm에 warp-agent-mcp를 출시했고, CargoAi는 2026년 6월 5일 CargoMART 서버를 출시했으며, 오픈소스 및 소포 서버도 함께 출시되었습니다. 이것이 제가 읽고 싶었던 후속 글로, 실제로 출시된 내용, 이 네 가지가 일치하는 부분, 그리고 설계 선택이 조용히 달라지는 부분을 해부합니다. 프로토콜 기본 사항을 보지 못했다면, 먼저 입문서를 읽고 다시 돌아오십시오.
실제로 출시된 서버
- Warp
warp-agent-mcp는 2026년 4월 16일 npm에 출시되었으며 MIT 라이선스를 취득했습니다. 이 서버는 실제 화물을 예약하기 위한 최초의 MCP 서버로 홍보되었습니다. Warp 자체 관리형 도로 네트워크에 대해 검색, 견적, 예약 및 추적에 이르는 약 23개의 도구를 노출합니다. - CargoAi CargoMART 는 2026년 6월 5일에 출시되었으며, 에이전트가 Copilot, ChatGPT, Claude 또는 Gemini 내에서 항공 화물을 검색, 견적 및 예약할 수 있도록 합니다. 이는 도로뿐만 아니라 항공 부문도 움직이고 있다는 가장 명확한 신호입니다.
- freightutils-mcp 는 오픈 소스 옵션으로, 약 19개의 무료 유틸리티 도구를 갖춘 TypeScript 패키지입니다. 라이브 네트워크에서 거래하기보다는 계산 및 참조 데이터에 중점을 두어 깔끔한 샌드박스 역할을 합니다.
- Easyship 은 550개 이상의 운송업체 통합을 통해 소포 및 소형 패키지 작업에 초점을 맞추고 요금, 라벨 생성 및 추적을 제공합니다. 소포 중심이므로 중량 화물과는 다른 모델링 가정을 따릅니다.
네 가지를 나란히 비교해 보면, 세 가지 질문에서 차이가 있습니다. 에이전트가 자격 증명 없이 할 수 있는 것, 가격이 지속되는 기간, 그리고 서버가 실행되는 위치입니다.
도구 범위: 에이전트가 할 수 있는 일
모든 서버는 도구 모음이며, 이 모음은 공급업체의 의도를 보여줍니다. Warp의 약 23개 도구는 용량 검색부터 추적 조회까지 종단 간 거래를 위해 구축되었기 때문에 가장 광범위한 세트입니다. CargoMART는 항공 예약 여정에 중점을 두어 검색, 견적 및 예약을 제공합니다. freightutils는 19가지 유틸리티를 통해 계산 및 조회 영역에 머무릅니다. Easyship은 요금, 라벨 및 추적을 제공하여 소포 요금-라벨 루프에 최적화되어 있습니다.
이것들을 화물 워크플로우에 매핑하면, 도구는 네 가지 작업으로 그룹화됩니다. 용량 찾기, 가격 책정, 예약 확정, 그리고 이동 추적. 처음 두 가지는 읽기만 하므로 위험이 낮습니다. 예약 확정은 실제 세상에 기록하고 비용을 지출합니다. 추적은 다시 읽기 전용이지만 가치가 높습니다. 왜냐하면 대부분의 인간 시간은 여전히 상태 추적에 소요되기 때문입니다.
에이전트는 MCP tools/list 메서드를 통해 서버가 제공하는 기능을 파악하고 tools/call을 사용하여 도구를 호출하므로, 에이전트가 읽는 이름이 중요합니다. get_quote, book_shipment 또는 get_tracking과 같이 디스패처가 인식하는 결과 이름을 사용하면 실제 에이전트와의 접촉에서도 이름이 유지됩니다. 원시 엔드포인트를 노출하는 이름은 모델이 배관을 오케스트레이션하도록 강제하며, 여기서 매개변수 발명이 발생합니다. Warp와 CargoMART 모두 결과 중심의 이름을 사용하며, 이는 REST 사양에서 역으로 적용된 것이 아니라 에이전트를 위해 설계되었음을 나타내는 조용한 신호입니다.
인증: 공개 견적, 제한된 예약
실제 서버 전반에 걸쳐 공유되는 패턴은 저라도 선택했을 것입니다. 견적 및 참조 도구는 공개적이거나 마찰이 적은데, 이는 에이전트가 경로의 가격을 산정하도록 허용하는 것이 무해하고 실제로 유용하기 때문입니다. 예약, 취소 및 송장에 영향을 미치는 모든 것은 API 키 또는 전체 OAuth 흐름 뒤에 있습니다. 예를 들어 Warp는 로컬 구성 파일 ~/.warp/config.json에서 키를 읽기 때문에 예약 도구는 인증된 경우에만 활성화됩니다.
{
"mcpServers": {
"warp": {
"command": "npx",
"args": ["-y", "warp-agent-mcp"],
"env": { "WARP_API_KEY": "your_key_here" }
}
}
}키가 없어도 에이전트는 탐색하고 견적을 낼 수 있습니다. 키가 있으면 에이전트는 사용자를 대신하여 비용을 지출할 수 있습니다. 데스크톱 사용의 경우 구성 파일의 정적 키는 허용 가능합니다. 예약되지 않은 상태로 예약하는 프로덕션 에이전트의 경우 정적 키는 보안 위험이며, 손상된 에이전트가 임의로 재예약하거나 취소할 수 없도록 PKCE와 범위 지정 및 취소 가능한 토큰을 갖춘 OAuth 2.1을 사용하는 것이 좋습니다. 이에 대해서는 별도의 보안 게시물에서 더 자세히 다룰 것입니다. 운송 예약은 일반적인 프롬프트 주입을 금전적 사건으로 만들기 때문입니다.
견적 유효성 함정
이것은 운송 분야에 새로 온 팀이 겪는 세부 사항입니다. 견적은 가격이 아니라 만료 날짜가 있는 가격입니다. 예를 들어 Warp의 견적은 며칠이 아닌 약 72시간의 유효 기간을 갖습니다. 월요일에 견적을 내고 금요일에 예약하려는 에이전트는 실패할 것이며, 단순한 재시도 루프는 토큰을 소진하면서 계속 실패할 것입니다.
따라서 서버는 유효성을 기계가 읽을 수 있도록 만들어야 하며, 에이전트는 이를 존중해야 합니다. 잘 구현된 프로그램은 명시적인 만료일과 견적 참조를 반환하고 예약 도구는 둘 다 확인합니다. 더 약한 구현은 빈 숫자를 반환하고 추측에 맡깁니다. 서버를 평가할 때 경로를 견적하고, 기다린 후, 만료된 견적에 대해 예약을 시도해 보세요. 실패하는 방식은 생산 강화가 얼마나 이루어졌는지 알려줍니다.
전송: stdio 대 호스팅 HTTP
프로토콜은 stdio와 Streamable HTTP의 두 가지 전송을 정의하며, 메시지는 어느 쪽이든 JSON-RPC 2.0입니다. npx로 시작하는 로컬 stdio 서버는 개발자가 자신의 계정에 Claude Desktop 또는 Cursor와 같은 데스크톱 도우미를 연결하는 데 적합합니다. 설정이 간단하고 자격 증명이 컴퓨터를 벗어나지 않습니다. 호스팅 HTTP 서버는 서비스로 실행되며, 이는 에이전트 그룹이 액세스 권한을 공유하거나, 중앙 로깅을 원하거나, API 키를 여러 노트북에 분산할 수 없을 때 필요한 것입니다.
freightutils와 npx로 시작되는 서버는 로컬 경로를 쉽게 만듭니다. 프로덕션 배포는 인증, 속도 제한 및 감사 추적을 처리하는 게이트웨이 뒤에 호스팅 HTTP를 사용합니다. 둘 다 틀린 것은 아닙니다. 실수는 stdio 프로토타입을 프로덕션으로 출시하고 에이전트가 예약한 내용에 대한 중앙 보기가 없다는 것을 발견하는 것입니다.
다중 운송업체 마켓플레이스 서버가 노출해야 하는 것
이것이 저의 관점이 나오는 부분인데, 저희는 단일 운송업체가 아니라 마켓플레이스를 운영하고 있으며, 모델링 문제는 실제로 다릅니다. 단일 운송업체 서버는 한 가지 질문에 답합니다: 내 네트워크에서 이것을 운송할 수 있으며, 얼마의 비용이 드는가? 마켓플레이스 서버는 더 어려운 질문에 답해야 합니다: 여러 운송업체 중에서 에이전트가 어떤 옵션을 선택해야 하며, 왜 그런가?
단일 운송사 서버에는 필요하지 않은 도구들이 강요됩니다. 에이전트는 단순히 하나의 견적을 가져오는 것이 아니라 여러 제안을 비교할 수 있어야 합니다. 에이전트는 가격과 운송 시간, 운송사 가용성을 결합한 순위 신호가 필요한데, 왜냐하면 현재 아무도 운행하지 않는 경로의 가장 저렴한 견적은 함정이기 때문입니다. 에이전트는 이미 사라진 용량으로 약속하지 않도록 정직한 가용성 정보가 필요합니다. 또한 추적이 실제로 해결되도록 예약된 배송이 특정 운송사 및 참조로 다시 조정될 수 있어야 합니다. 바쁜 경로에서는 에이전트가 12개의 견적을 보고 그날 예약 가능한 것은 3~4개뿐일 수 있으며, 당사 데이터에 따르면 가장 저렴한 견적과 가장 저렴하게 예약 가능한 견적 간의 차이는 실질적이고 반복적입니다. 해당 차이를 숨기는 마켓플레이스 서버는 에이전트에게 불이익을 주는 것입니다. 우리가 계속해서 배우는 교훈은 가용성 없는 가격은 마케팅이지 예약이 아니라는 것입니다.
화물 MCP 서버 평가 방법
하나를 선택하는 경우, 랜딩 페이지보다는 실제 서버에서 이 짧은 체크리스트를 실행하십시오.
- 도구 이름. 운송 담당자가 인식하는 결과에 대한 설명인가요, 아니면 원시 엔드포인트를 노출하는 건가요?
- 자격 증명 경계. 키 없이 작동하는 것은 무엇이며, 예약 시 무엇이 필요합니까? 무인 사용을 위한 범위가 지정된 OAuth 경로가 있습니까?
- 견적 유효성. 만료일이 명시적으로 반환되며, 예약 도구가 만료된 견적을 깔끔하게 거부합니까?
- 전송. 데스크톱용 로컬 stdio, 플릿을 위한 호스팅 HTTP. 공급업체는 실제로 필요한 것을 지원합니까?
- 커버리지 정직성. 단일 운송사 또는 여러 운송사인가요? 여러 운송사라면 에이전트가 불투명한 단일 숫자가 아닌 가용성과 순위를 볼 수 있습니까?
- 관찰 가능성. 사후에 에이전트가 어떤 견적을 내고 예약했는지 감사할 수 있습니까?
시장은 한 분기 만에 싱크피스에서 패키지로 이동했으며, 이는 물류 기술 표준으로도 빠른 속도입니다. 구축하는 경우, 입문서와 이 분해 분석이면 이번 주에 에이전트를 실제 네트워크에 연결하기에 충분할 것입니다. 구매하는 경우, 위의 체크리스트를 통해 데모와 예약 엔진을 구분할 수 있습니다. GetTransport와 같은 마켓플레이스에서는 동일한 원리가 에이전트가 돈을 지출하도록 신뢰할 수 있는지 여부를 결정하며, 이러한 신뢰는 도구 목록의 크기가 아니라 가용성과 유효성을 기반으로 구축됩니다.
자주 묻는 질문
화물 MCP 서버란 무엇인가요?
AI 어시스턴트가 모델 컨텍스트 프로토콜을 통해 호출할 수 있는 도구로 견적, 예약, 추적과 같은 화물 작업을 노출하는 작은 서비스로서, 에이전트가 개별 운송사 API를 학습하는 대신 한 번만 통합할 수 있도록 합니다.
2026년에 어떤 화물 MCP 서버가 존재하나요?
주요 서버로는 도로 화물 예약용 Warp의 warp-agent-mcp, 항공 화물용 CargoAi의 CargoMART, 계산 및 참조 데이터용 오픈 소스 freightutils-mcp, 소포 요금 및 라벨용 Easyship 등이 있습니다.
AI 에이전트가 API 키 없이 화물을 예약할 수 있나요?
보통은 그렇지 않습니다. 대부분의 서버는 에이전트가 자격 증명 없이 데이터를 견적하고 조회할 수 있도록 허용하지만, 예약, 취소 및 송장 작업에는 인증된 키 또는 OAuth 토큰이 필요하므로 승인된 에이전트만 돈을 지출할 수 있습니다.
MCP 서버에서 반환된 화물 견적이 만료되는 이유는 무엇인가요?
화물 가격은 용량과 연료에 따라 변동하므로 견적은 몇 시간 동안만 유효한 짧은 기간 동안만 유효합니다. 서버는 만료일을 반환하며, 에이전트는 다시 시도하기보다는 새 견적을 재예약해야 합니다.
단일 운송사 MCP 서버가 아닌 마켓플레이스 MCP 서버는 무엇을 노출해야 하나요?
에이전트가 운송사 간의 제안을 비교하고, 가격과 운송 시간 및 가용성을 결합한 순위를 보고, 예약을 특정 운송사로 다시 조정할 수 있도록 해야 합니다. 왜냐하면 가장 저렴한 견적이 항상 실제로 예약할 수 있는 견적이 아니기 때문입니다.