MCP 연결 · API 키 발급 안내

법마디(Lawmadi) OS MCP 서버에 연결하고 도구 호출용 API 키를 발급받는 전체 절차입니다. 이 안내는 로그인 없이 볼 수 있고, 키 발급은 아래에서 이메일 인증 후 즉시 진행됩니다.

서버 등록·헬스체크에는 키가 필요하지 않습니다. initialize·tools/list·ping(디스커버리)은 인증 없이 응답합니다. 키는 tools/call(실제 도구 실행)에만 필요합니다.

1. 연결 정보

MCP 클라이언트·플랫폼에 아래 값을 그대로 입력하면 됩니다.

MCP 엔드포인트https://lawmadi.com/mcp
전송 방식Streamable HTTP — JSON-RPC 2.0을 POST로 전송 (요청당 JSON 응답)
MCP 식별자lawmadios · 서버명 Lawmadi OS
프로토콜 버전2024-11-05 · 2025-03-26 · 2025-06-18 · 2025-11-25 (클라이언트가 요청한 버전을 그대로 협상)
인증 방식Key/Token — HTTP 헤더 Authorization: Bearer <API 키>
GET /mcp서버→클라이언트 SSE 채널은 제공하지 않으므로 405 Method Not Allowed를 반환합니다(MCP 스펙상 정상 동작). 모든 호출은 POST를 사용하세요.
키 없이
initializetools/listpingget_pricing
서버 등록·상태 점검·요금과 키 발급 경로 조회까지 인증 없이 됩니다. 등록 플랫폼의 헬스체크가 여기에 해당합니다.
키 필요
askask_expertlookup_statutelookup_precedentverify_citationsgenerate_document
그 외 모든 tools/call 입니다. 키를 보내지 않으면 -32001, 키가 잘못됐거나 폐기된 경우 -32002 와 함께 발급 경로를 응답에 담아 돌려줍니다.
키만으로는 열리지 않는 도구가 하나 있습니다 — ask_expert(전문가용 답변, 2크레딧)는 Pro 요금제 전용입니다. 잔액이 있어도 Pro가 아니면 거절되며, 이때 크레딧은 차감되지 않고 응답에 필요한 요금제와 구매 링크가 함께 담깁니다. 일반 답변 ask(1크레딧)는 요금제와 무관하게 사용할 수 있습니다.

2. API 키 발급 — 어디서 하나요?

별도 심사·신청서 없이, 이메일 인증만으로 이 페이지에서 바로 발급합니다. 발급된 키는 서버에 해시로만 저장되므로 생성 직후 1회만 전체가 표시됩니다.

01

이메일 로그인

이메일로 받은 6자리 코드만 입력합니다. 신청서·심사 절차가 없습니다.

회원가입 절차 없음무료 크레딧 3개 · 최초 1회
02

키 발급 — 이 페이지에서

아래 API 키 발급 버튼을 누르면 즉시 생성됩니다. 서버는 해시만 보관하므로 전체 키는 이때 1회만 표시됩니다.

lmk_live_…활성 키 최대 10개폐기 즉시 무효
03

Bearer 헤더로 전송

MCP 클라이언트에 헤더로 넣으면 tools/call 이 열립니다.

Authorization: Bearer lmk_live_…
04

필요할 때 크레딧 충전

무료 크레딧을 다 쓴 뒤 요금제 페이지에서 구매합니다. 구매 크레딧은 유효기간이 없습니다.

조회 도구는 크레딧 미소모
로그인 상태를 확인하는 중…

3. 에이전트라면 — OAuth 2.0 으로 키를 받으십시오

자율 에이전트는 사용자에게 이 페이지에서 키를 복사해 달라고 하지 마십시오. 스스로 등록하고, 동의 화면을 한 번만 거치게 하고, 그 뒤로는 직접 갱신하면 됩니다 — 보조 도구가 메일·드라이브 계정에 연결되는 방식과 같습니다.

01

메타데이터를 읽습니다

GET /.well-known/oauth-authorization-server(RFC 8414)와 GET /mcp/.well-known/oauth-protected-resource(RFC 9728). 인증을 지원하는 MCP 클라이언트는 tools/call 전에 뒤쪽 문서를 먼저 읽습니다.

RFC 8414RFC 9728
02

스스로 등록합니다

POST /oauth/registerredirect_uris 를 보내면 됩니다 — 사전 협의 없이 누구나 가능합니다(RFC 7591). 네이티브 에이전트를 위해 루프백 http://127.0.0.1:포트/… 도 받습니다(RFC 8252).

RFC 7591승인 절차 없음
03

동의 한 번, 그 뒤로는 자율

사용자를 /oauth/authorize 로 보내고(code_challenge_method=S256 필수 — plain 은 지원하지 않습니다), 받은 코드를 /oauth/token 에서 교환합니다. refresh 토큰을 받아 직접 회전시키면 됩니다.

PKCE S256 전용refresh 회전
04

가능하면 좁은 스코프를 요청하십시오

mcp:read사용자 크레딧을 쓸 수 없습니다. 과금 도구는 거절되고, 검증자산 조회는 하루 무료 할당에서 멈추지 과금되지 않습니다. 사람은 mcp 보다 이쪽을 훨씬 쉽게 승인합니다.

mcpmcp:read

발급되는 액세스 토큰은 lmk_live_… 키입니다 — 이 페이지가 주는 것과 같은 자격입니다. 한도·일일 할당·과금·get_account 가 똑같이 동작하고, 사용자는 자기 키 목록에서 폐기할 수 있습니다. 맞춰 관리할 두 번째 인증 경로를 만들지 않았습니다.

에이전트가 함께 묻는 표면 둘: POST /a2a(에이전트 카드 /.well-known/agent-card.json) — 태스크를 동기로 끝냅니다. 스트리밍과 푸시 알림은 false 로 선언하고 거절합니다(이 호스트가 SSE 를 버퍼링하기 때문입니다). 그리고 x402 기계 결제는 구현했지만 켜지 않았습니다 — 온체인 지갑이 없어 /.well-known/x402 가 의도적으로 404 입니다. 그때까지는 브라우저에서 크레딧을 구매하십시오.

4. 클라이언트 설정 예시

발급한 키를 Authorization 헤더에 넣는 방식은 모든 MCP 클라이언트에서 동일합니다.

MCP 클라이언트 설정(JSON)
{
  "mcpServers": {
    "lawmadi": {
      "type": "http",
      "url": "https://lawmadi.com/mcp",
      "headers": {
        "Authorization": "Bearer lmk_live_여기에_발급받은_키"
      }
    }
  }
}
키 없이 연결 확인(디스커버리)
curl -s https://lawmadi.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"health-check","version":"1"}}}'
키로 도구 호출
curl -s https://lawmadi.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer lmk_live_여기에_발급받은_키' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"lookup_statute","arguments":{"reference":"민법 제750조"}}}'
키 발급 경로·요금·잔액은 도구로도 확인할 수 있습니다. get_pricing은 인증 없이 호출 가능하며 가입→키 발급→충전 순서를 그대로 돌려주고, get_account는 키로 잔액을 확인합니다.

5. 키 관리 규칙

6. 전문가 REST API 키와의 차이

두 종류의 키가 있습니다. MCP 연결에는 이 페이지에서 발급하는 키를 사용하세요.

MCP 키 (이 페이지)이메일 로그인만으로 발급 · https://lawmadi.com/mcp 도구 호출용 · 크레딧 종량 과금
전문가 REST API 키B2B /api/v1/expert/ask 전용 · Pro 요금제 가입 시 전문가 API 콘솔에서 발급 · 자세한 내용은 전문가 API 소개
발급이 진행되지 않거나 심사·검증용 키가 필요하시면 admin@lawmadi.com 으로 문의해 주세요.