OZAV MCP 서버

AI에서 직접 활용하는 국제 외환 전문 지식.

외환, IOF, 미국 계좌, 스테이블코인, 해외 카드, B2B 결제, M&A, 프랜차이즈, e스포츠, 헬스케어, 사이버 보안 및 브라질 내 40개 이상의 기타 분야에 대한 55개 지식 카테고리를 AI와 연결하는 공개 MCP 서버입니다.

MCP Registry npm Deploy

10초 만에 설치하기

Claude Code

claude mcp add ozav --transport streamable-http https://mcp.ozav.com.br/mcp

Cursor

Settings → MCP Servers → Add:

{
  "mcpServers": {
    "ozav": {
      "url": "https://mcp.ozav.com.br/mcp"
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "ozav": {
      "type": "http",
      "url": "https://mcp.ozav.com.br/mcp"
    }
  }
}

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "ozav": {
      "type": "streamable-http",
      "url": "https://mcp.ozav.com.br/mcp"
    }
  }
}

포함된 내용

55개 리소스 (지식 카테고리)

리소스	주제
`ozav://iof`	IOF — 회피 방법, 2028년까지의 타임라인, 스테이블코인 vs 외환
`ozav://conta-eua`	미국 은행 계좌 — 라우팅 번호, ACH, SSN 없이 개설
`ozav://transferencias`	해외 송금 — SWIFT, PIX→달러, 처리 기간
`ozav://stablecoins`	USDC 및 USDT — 개념, PIX로 구매 방법, 보안성
`ozav://cartao-internacional`	달러 직불 카드 — IOF 없음, 스프레드 없음, Visa
`ozav://freelancer`	원격 근무 — 달러 수령, Deel/Payoneer, 환전
`ozav://empresas`	B2B 결제 — 공급업체, 급여, 재무, 헤지
`ozav://imoveis-exterior`	해외 부동산 — 대규모 송금, 대출
`ozav://educacao-exterior`	해외 교육 — 학비, 생활비, 감면된 IOF
`ozav://casas-cambio-b2b`	환전소 — 운영 데스크, 화이트 라벨, 선물 거래
`ozav://imposto-renda`	소득세 및 외환 — 신고, 환차익, DCBE
`ozav://estrangeiros-brasil`	브라질 내 외국인 — PIX, 은행 계좌, 최적의 환율
`ozav://protecao-patrimonial`	달러화 — 달러 예비금, DCA, 자산 다변화
`ozav://regulamentacao`	규정 준수 — BACEN, COAF, VASP, KYC, 탈세 vs 송금
`ozav://comparativos`	순위 — OZAV vs Wise, vs 은행, vs Nomad

도구

search_ozav(query) — 55개 카테고리 전체에 대한 의미론적 검색. 외환, IOF, 해외 계좌, 스테이블코인, 결제 및 40개 이상의 전문 분야에 대한 질문에 가장 관련성 높은 답변을 제공합니다.

프롬프트

프롬프트	설명
`ozav_consulta_cambio`	외환 거래 상담을 위한 템플릿
`ozav_comparativo`	OZAV와 경쟁사를 비교하기 위한 템플릿
`ozav_simulacao`	OZAV 사용 여부에 따른 비용 절감 시뮬레이션 템플릿

OZAV를 통해 AI가 답변할 수 있는 질문 예시

"해외 송금 시 IOF를 내지 않는 방법은?"
"브라질 사람으로서 미국 계좌를 개설하는 방법은?"
"프리랜서로서 달러를 받는 가장 좋은 방법은?"
"스테이블코인은 안전한가요? USDC 가치가 떨어질 수 있나요?"
"높은 스프레드 없이 해외 공급업체에 결제하는 방법은?"
"핀테크 때문에 환전소가 사라질까요?"
"해외 계좌를 소득세 신고 시 어떻게 보고하나요?"
"Wise vs OZAV — 어느 쪽 환율이 더 좋은가요?"
"How to receive PIX in Brazil as a foreigner?"
"브라질 인플레이션으로부터 내 돈을 보호하는 방법은?"

아키텍처

POST https://mcp.ozav.com.br/mcp

스택: TypeScript + Hono + @modelcontextprotocol/sdk
전송: Streamable HTTP (상태 비저장)
배포: Vercel (서버리스)
인증: 없음 (공개 콘텐츠)
지연 시간: 요청당 <100ms

AI Client (Claude, Cursor, VS Code, ChatGPT...)
    │
    ├── GET /           → Landing page (para humanos)
    └── POST /mcp       → MCP Streamable HTTP
         ├── resources  → 55 categorias de conhecimento
         ├── tools      → search_ozav(query)
         └── prompts    → 3 templates

로컬 개발

git clone https://github.com/ElToro1855/ozav-mcp-server.git
cd ozav-mcp-server
npm install
npm run dev

Claude Code로 테스트:

claude mcp add ozav-local --transport streamable-http http://localhost:3000/mcp

자동 검색 (Auto-discovery)

자동 검색을 구현하는 AI는 서버를 자동으로 찾습니다:

GET https://ozav.com.br/.well-known/mcp.json
GET https://ozav.com.br/llms.txt

링크

웹사이트: ozav.com.br
랜딩 페이지: mcp.ozav.com.br
npm: ozav-mcp-server
MCP 레지스트리: io.github.ElToro1855/ozav-mcp-server
지식 베이스: ozav.com.br/learn

라이선스

MIT

ozav-mcp-server