법마디(Lawmadi) OS MCP 서버에 연결하고 도구 호출용 API 키를 발급받는 전체 절차입니다. 이 안내는 로그인 없이 볼 수 있고, 키 발급은 아래에서 이메일 인증 후 즉시 진행됩니다.
initialize·tools/list·ping(디스커버리)은 인증 없이 응답합니다. 키는 tools/call(실제 도구 실행)에만 필요합니다.
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크레딧)는 요금제와 무관하게 사용할 수 있습니다.별도 심사·신청서 없이, 이메일 인증만으로 이 페이지에서 바로 발급합니다. 발급된 키는 서버에 해시로만 저장되므로 생성 직후 1회만 전체가 표시됩니다.
이메일로 받은 6자리 코드만 입력합니다. 신청서·심사 절차가 없습니다.
아래 API 키 발급 버튼을 누르면 즉시 생성됩니다. 서버는 해시만 보관하므로 전체 키는 이때 1회만 표시됩니다.
MCP 클라이언트에 헤더로 넣으면 tools/call 이 열립니다.
무료 크레딧을 다 쓴 뒤 요금제 페이지에서 구매합니다. 구매 크레딧은 유효기간이 없습니다.
자율 에이전트는 사용자에게 이 페이지에서 키를 복사해 달라고 하지 마십시오. 스스로 등록하고, 동의 화면을 한 번만 거치게 하고, 그 뒤로는 직접 갱신하면 됩니다 — 보조 도구가 메일·드라이브 계정에 연결되는 방식과 같습니다.
GET /.well-known/oauth-authorization-server(RFC 8414)와 GET /mcp/.well-known/oauth-protected-resource(RFC 9728). 인증을 지원하는 MCP 클라이언트는 tools/call 전에 뒤쪽 문서를 먼저 읽습니다.
POST /oauth/register 에 redirect_uris 를 보내면 됩니다 — 사전 협의 없이 누구나 가능합니다(RFC 7591). 네이티브 에이전트를 위해 루프백 http://127.0.0.1:포트/… 도 받습니다(RFC 8252).
사용자를 /oauth/authorize 로 보내고(code_challenge_method=S256 필수 — plain 은 지원하지 않습니다), 받은 코드를 /oauth/token 에서 교환합니다. refresh 토큰을 받아 직접 회전시키면 됩니다.
mcp:read 는 사용자 크레딧을 쓸 수 없습니다. 과금 도구는 거절되고, 검증자산 조회는 하루 무료 할당에서 멈추지 과금되지 않습니다. 사람은 mcp 보다 이쪽을 훨씬 쉽게 승인합니다.
발급되는 액세스 토큰은 곧 lmk_live_… 키입니다 — 이 페이지가 주는 것과 같은 자격입니다. 한도·일일 할당·과금·get_account 가 똑같이 동작하고, 사용자는 자기 키 목록에서 폐기할 수 있습니다. 맞춰 관리할 두 번째 인증 경로를 만들지 않았습니다.
에이전트가 함께 묻는 표면 둘: POST /a2a(에이전트 카드 /.well-known/agent-card.json) — 태스크를 동기로 끝냅니다. 스트리밍과 푸시 알림은 false 로 선언하고 거절합니다(이 호스트가 SSE 를 버퍼링하기 때문입니다). 그리고 x402 기계 결제는 구현했지만 켜지 않았습니다 — 온체인 지갑이 없어 /.well-known/x402 가 의도적으로 404 입니다. 그때까지는 브라우저에서 크레딧을 구매하십시오.
발급한 키를 Authorization 헤더에 넣는 방식은 모든 MCP 클라이언트에서 동일합니다.
{
"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는 키로 잔액을 확인합니다.
tools/call은 곧바로 거부됩니다.lookup_precedent·lookup_statute·bar_exam_search·find_village_lawyer·latest_content)는 LLM을 호출하지 않아 크레딧을 소모하지 않습니다(키당 일일 캡 적용, 00:00 KST 리셋). verify_citations는 LLM을 호출하지 않지만 유료 도구로, 1회에 크레딧 1개를 사용합니다(일일 캡은 적용되지 않습니다 — 크레딧이 곧 한도입니다).-32002)을 받으면 오타·폐기 여부를 확인하고 이 페이지에서 재발급하세요.두 종류의 키가 있습니다. MCP 연결에는 이 페이지에서 발급하는 키를 사용하세요.
| MCP 키 (이 페이지) | 이메일 로그인만으로 발급 · https://lawmadi.com/mcp 도구 호출용 · 크레딧 종량 과금 |
|---|---|
| 전문가 REST API 키 | B2B /api/v1/expert/ask 전용 · Pro 요금제 가입 시 전문가 API 콘솔에서 발급 · 자세한 내용은 전문가 API 소개 |