지난 10년 가까이 저는 후회할 만큼 많은 보일러플레이트 코드를 작성하는 데 시간을 보냈습니다. 초창기 PHP 시절에는 파일을 FTP로 전송하는 것이었고, 현대 시대에는 새로운 Claude 모델이 출시되었는지 확인하거나 프롬프트가 토큰 예산을 얼마나 소모할지 보기 위해 커스텀 Python 스크립트를 작성하는 것입니다.

우리는 '에이전트 워크플로우(agentic workflows)'를 구축한 지점에 이르렀지만, 개발자가 Anthropic과 상호작용하는 에이전트를 원할 때 하는 첫 번째 일은 API 래퍼를 작성하는 것입니다. 이는 불필요한 작업입니다. 만약 Cursor나 Claude Desktop에서 Claude를 사용하고 있다면, 모델이 자체 소스와 통신할 수 있어야 합니다.

Anthropic MCP 서버는 Messages API를 별도의 통합 작업이 아닌 일련의 도구(tools)로 전환함으로써 이 문제를 해결합니다. 이는 AI 에이전트를 API 자체에 대한 오케스트레이션 레이어(orchestration layer)로 만듭니다.

'그냥 API를 사용하라'는 것의 문제점

LLM으로 구축할 때 숨겨진 세금이 있습니다: 컨텍스트 관리와 비용 불확실성입니다. 프롬프트를 보내면 작동합니다. 조금 더 큰 것을 보내면 컨텍스트 제한에 걸리거나 예상보다 3배 많은 비용이 발생합니다.

만약 에이전트가 MCP를 통해 count_tokens 도구에 접근할 수 있다면, 워크플로우는 근본적으로 바뀝니다. 무작정 거대한 페이로드를 보내고 제공업체 신에게 기도하는 대신, 에이전트는 프롬프트를 '사전 점검(pre-flight)'할 수 있습니다. 메시지 배열을 확인하고 입력 토큰 수를 계산한 다음, 인간의 개입 없이 컨텍스트를 잘라내야 할지 아니면 진행해도 안전한지 결정할 수 있습니다.

이것은 단순히 편의성의 문제가 아닙니다. 복잡한 추론 작업 수행 중 하드 리밋에 걸려 중간에 실패하지 않는, 신뢰할 수 있고 자율적인 시스템을 구축하는 문제입니다.

무거운 작업을 관리하기: 일급 시민으로서의 배치(Batching)

무거운 작업을 관리하기: 일급 시민으로서의 배치(Batching)

Anthropic의 배치 API를 사용해 본 사람이라면, 예산을 소진하지 않으면서 대용량의 독립적인 요청을 처리하는 유일한 방법이라는 것을 알 것입니다. 표준 요청보다 50% 저렴합니다. 하지만 배치를 전통적으로 관리하는 것은 매우 번거롭습니다. 제출하고 ID를 받은 다음, in_progress, succeeded, 또는 failed 상태인지 확인하기 위해 폴링(polling) 메커니즘이나 웹훅 핸들러를 설정해야 합니다.

이 MCP 서버를 사용하면 배치 처리를 다른 어떤 명령어처럼 다룰 수 있습니다. 에이전트에게

저는 너무 많은 개발자들이 raw HTTP 요청을 루프(loop)로 사용하여 자신들의 명예의 전당급 MCP 서버를 만들려고 시도하는 것을 보았습니다. 그것은 작동하지 않습니다. 인증되지 않았고, 샌드박스(sandbox)가 없습니다.

Vinkius를 구축했을 때 목표는 정확히 이것이었습니다: 'OAuth 콜백 구성'이라는 마찰을 제거하고, 클라이언트에 붙여넣기만 하는 연결 토큰으로 대체하는 것입니다. 하지만 더 중요한 것은, 상황이 잘못되었을 때 무슨 일이 발생하는지에 초점을 맞췄다는 점입니다. 저희 엔진을 통해 실행되는 모든 서버는 격리된 V8 샌드박스를 사용합니다. 에이전트에게 create_batch_message를 실행하거나 API 키와 상호 작용할 수 있는 권한을 부여한다면, 거버넌스(governance)가 필요합니다—DLP(데이터 손실 방지), SSRF 방지, 감사 체인(audit chain)은 선택적 기능이 아니라, 취미 프로젝트가 아닌 모든 것의 필수 요건입니다.

사용할 수 있다면. 저희가 MCPFusion을 통해 근본적인 구현을 어떻게 처리하는지 보고 싶다면, 저희 레포지토리를 확인해 보세요.

요약

에이전트를 위한 커스텀 API 래퍼(wrapper)를 작성하던 시대는 끝을 향하고 있습니다. 우리는 API가 에이전트의 도구 상자 속 또 하나의 기능일 뿐인 세상으로 나아가고 있습니다. HTTP 보일러플레이트(boilerplate) 관리를 중단하고 실제 오케스트레이션 로직(orchestration logic) 구축을 시작하려면, 이렇게 하시면 됩니다.

MCP는 AI 에이전트의 음악입니다. 저희가 카탈로그를 만들었습니다. Vinkius MCP 카탈로그를 발견해 보세요.