연동 · 개발

개발자 · 연동 안내

Native Agent Authorization Cloud API · SDK · Webhook · MCP catalog.

웹 앱

브라우저 dApp

지금 보시는 /app — 데모와 역할별 화면이 운영 API에 연결됩니다.

REST API

HTTP로 바로 호출

Mandate · Verify · Evidence · SafePay Authorization을 HTTP로 호출합니다.

SDK 패키지

TypeScript 클라이언트

@midgo/sdk로 Cloud API를 호출하고, @midgo/mcp로 에이전트 도구 카탈로그에 연결합니다.

Webhook · MCP

이벤트 · 도구

mandate/verify 이벤트를 outbound webhook으로 받고, MCP tool catalog로 Agent에 붙입니다.

운영 API

https://midgo-api-production.up.railway.app
GET  /ready
GET  /v1/capabilities
POST /v1/mandates · /v1/mandates/standing
POST /v1/authorizations/verify
POST /v1/safepay/authorize-and-prepare
POST /v1/developer/webhooks
GET  /v1/developer/mcp-tools

import { createMidgoClient } from "@midgo/sdk"
const midgo = createMidgoClient({ baseUrl, apiKey, tenantId })

OpenAPI 명세는 저장소 docs/openapi.yaml (agent-auth · developer 태그)

주요 패키지

@midgo/sdk — Midgo Cloud HTTP 클라이언트
@midgo/mcp — stdio MCP bridge (tools/list · tools/call)
@midgo/trust-core — Native Authorization 도메인
@midgo/oid4vp — 신원(VP) 검증

API 키는 MIDGO_API_KEY (x-api-key / Bearer). Webhook은 POST /v1/developer/webhooks.

앱에서 실행 capabilities 보기 이용 안내