원문 캡처 · github.com
원문 캡처 · github.com

Charter는 고객 계정에 접근하는 에이전트의 API 요청을 필드별 규칙으로 제한하는 오픈소스 Python 라이브러리다. 호출을 보내기 전에 규칙을 검사하고, 같은 선언에서 에이전트가 접근할 수 있는 항목을 목록으로 만들어 코드 리뷰에 활용하도록 설계됐다.

도구마다 API 필드를 반영한 Pydantic 모델을 정의하고, 허용값이나 상한 같은 규칙을 붙인다. 호출 대상 고객 계정은 모델이 지정하지 못하도록 앱이 호출마다 전달할 수 있다. 규칙에 맞지 않는 요청은 전송 전에 거부된다. Charter는 서비스가 아니라 앱 프로세스 안에서 실행되며, 제작자는 프록시와 호출별 요금, 텔레메트리가 없다고 설명한다.

설치에는 Python 3.10 이상이 필요하고, 의존성은 pydantic과 httpx다.

text
pip install charter-ai

Charter는 Gmail, Slack, Stripe, Linear 등 17개 API를 위한 도구 687개를 제공한다. 기존 에이전트 프레임워크와 함께 쓸 수 있고, MCP로 도구 묶음을 제공하는 기능도 포함한다. 도구 목록과 빠른 시작 안내에서 적용 범위와 사용 방법을 확인할 수 있다.

R28은 라이브 계정에서 534회 실행한 비교에서 일반 HTTP 도구가 잘못된 GraphQL 문서 32건과 선언되지 않은 엔드포인트 호출 10건을 보낸 반면 Charter에서는 두 유형 모두 발생하지 않았다고 밝혔다. 이 수치는 제작자가 제시한 측정 결과다. 다만 Charter는 한 번의 요청을 다루며, 반복 실행과 재시도, 여러 단계의 흐름은 에이전트가 맡아야 한다. 멀티파트 업로드와 요청 서명, 스트리밍은 아직 지원하지 않는다.