AgentBureau: 에이전트 시대를 위한 공증인

Name: AgentBureau: The Embodiment Protocol for AI Agents (x402 + MCP)
Author: JustinGuese

Github: https://github.com/JustinGuese/AgentBureau-402-embodiment-as-a-service

AgentBureau는 AI 에이전트가 독일 관할권 내에서 운영될 수 있도록 법적 및 물리적 인프라를 제공합니다. 우리는 "Embodiment-as-a-Service(서비스형 구현)"를 제공함으로써 디지털 지능과 현실 세계의 행동 사이의 간극을 메웁니다.

API를 통해 에이전트는 은행 계좌, 실제 주소 또는 인간의 신원 없이도 팩스 발송, 실물 우편 발송, 송장 발행, 회사 설립(GmbH/UG), 세금 규정 준수 처리 및 법인 은행 계좌 개설과 같은 법적 구속력이 있는 작업을 수행할 수 있습니다.

핵심 메커니즘: x402 결제 게이팅

AgentBureau는 결제가 곧 인증인 에이전트 네이티브 인증 방식인 x402 프로토콜을 사용합니다.

API 키 없음: 에이전트가 비밀 정보를 관리하거나 계정을 생성할 필요가 없습니다.
허가 불필요: 결제는 온체인(Base L2의 USDC)에서 이루어집니다.
기계 판독 가능: 모든 요청은 402 "결제 필요(Payment Required)" 챌린지를 자율적으로 처리할 수 있도록 구조화된 메타데이터를 반환합니다.

이용 가능한 서비스

서비스	도구 이름	가격 (USDC)	전달 방식
디지털 송장	`send_german_invoice`	5.00	Lexoffice 경유
실물 우편	`send_letter`	3.00	Pingen 경유 (독일)
프로그래밍 방식 팩스	`send_fax`	1.00	Telnyx 경유
GmbH 설립	`form_german_company`	3,000.00*	HITL 컨시어지
UG 설립	`form_german_company`	1,500.00*	HITL 컨시어지
은행 계좌	`open_bank_account`	500.00	핀테크 통합
VAT 등록	`register_vat`	500.00	세무 포털 동기화
VAT 신고	`submit_vat_return`	100.00	월간/분기별
연례 보고	`create_annual_filing`	200.00	연방 관보(Bundesanzeiger)
채권 추심	`collect_debt`	50.00	추심 자동화
EU 거점	`eu_presence_bundle`	5,000.00	완전한 법적 보호

*설립 수수료에는 안전한 에스크로 워크플로우를 통해 처리되는 필수 자본금(Stammkapital)이 포함되어 있지 않습니다.

실행 가능한 코드 예제

우리는 다양한 언어와 프레임워크 전반에 걸쳐 AgentBureau 서비스를 통합하는 방법을 보여주는 포괄적인 6×4 실행 가능 스크립트 매트릭스를 제공합니다. 이 예제들은 전체 x402 흐름인 챌린지 → 결제 → 재시도를 처리합니다.

통합 매트릭스

클라이언트 / 언어	팩스	우편	송장	GmbH
cURL / Bash	fax.sh	letter.sh	invoice.sh	gmbh.sh
Python (httpx)	fax.py	letter.py	invoice.py	gmbh.py
TypeScript (viem)	fax.ts	letter.ts	invoice.ts	gmbh.ts
LangChain	fax.py	letter.py	invoice.py	gmbh.py
Claude Tool Use	fax.py	letter.py	invoice.py	gmbh.py
OpenAI Responses	fax.py	letter.py	invoice.py	gmbh.py

예제 실행 방법

예제 디렉토리로 이동:
```
cd examples
```

환경 설정:

cp .env.example .env
# Edit .env with your PRIVATE_KEY (Base network) and RPC_URL

설치 및 실행:
- Python: pip install -r <folder>/requirements.txt && python <folder>/<file>.py
- TypeScript: cd typescript && npm install && npx ts-node <file>.ts
- Shell: bash curl/<file>.sh

MCP 통합

AgentBureau는 MCP 네이티브입니다. mcp_servers.yaml에 다음을 추가하여 MCP 호환 에이전트(예: Claude Desktop)에 도구를 추가할 수 있습니다:

mcpServers:
  agent-bureau:
    command: npx
    args:
      [
        '-y',
        '@modelcontextprotocol/server-http',
        'https://agentbureau-api.datafortress.cloud/mcp',
      ]

*참고: 최상의 경험을 위해 클라이언트가 지원하는 경우 SSE 전송을 직접 사용하십시오.

웹사이트 개발

이 저장소에는 agentbureau.de 웹사이트 및 문서에 대한 소스 코드가 포함되어 있습니다.

기술 스택

프레임워크: Astro 5 (문서용 Starlight)
스타일링: Tailwind CSS v4
인터랙티브 아일랜드: React

시작하기

의존성 설치:
```
npm install
```
개발 서버 시작:
```
npm run dev
```
프로덕션용 빌드:
```
npm run build
```

문서

법적 프레임워크(ZAG 면제, Störerhaftung), 상세 API 참조 및 에이전트별 통합 가이드를 포함한 전체 문서는 /docs에서 확인할 수 있습니다.

마케팅 및 커뮤니티

AgentBureau는 다음 에이전트 레지스트리 및 허브에 통합되고 있습니다:

MCP 레지스트리: Smithery, Glama, Awesome-MCP
에이전트 생태계: LangChain Hub, CrewAI Tools
에이전트 경제: Coinbase Developer Platform, Base Ecosystem

AgentBureau: The Embodiment Protocol for AI Agents (x402 + MCP)