1acre MCP

1acre.in — 인도의 검증된 토지 마켓플레이스를 위한 공식 MCP(Model Context Protocol) 서버입니다. Claude Code, Cursor, Claude Desktop 또는 MCP 호환 클라이언트를 연결하여 1acre 계정을 대신해 지번 조회, 지적 데이터 탐색, 토지 인텔리전스 보고서 생성을 할 수 있습니다.

이 저장소는 클라이언트 측 구성 및 문서를 포함합니다 — 연결 방법에 대한 내용입니다. 서버 자체는 https://mcp.1acre.in에서 실행됩니다.

할 수 있는 것

연결되면 모든 MCP 클라이언트는 로그인한 1acre 사용자로 다음 도구를 호출할 수 있습니다:

유료 도구는 "1a" 토큰 잔액에서 사용됩니다: create_survey_number_report 및 identify_parcel_at_point는 각 실행당 10토큰이 소모됩니다. 무료 도구는 비용이 들지 않습니다 — 보고서가 생성되면 추가 토큰 없이 원하는 만큼 다시 열고 경계 좌표를 가져올 수 있습니다.

먼저 get_token_balance를 호출하세요(무료) — 실시간 잔액과 현재 도구별 가격을 확인할 수 있습니다. 잔액을 초과하는 실행은 insufficient_tokens 오류로 실패하며 복구 가능합니다 — 1acre의 My Tokens 페이지에서 충전한 후 다시 시도하세요.

여기서 "토큰"은 1acre 토지 인텔리전스 크레딧을 의미합니다 — MCP 클라이언트가 로그인을 위해 관리하는 OAuth 액세스 토큰과는 무관합니다.

Related MCP server: mcp-rosreestr

빠른 시작 — Claude Code

claude mcp add --scope user --transport http 1acre https://mcp.1acre.in/mcp \
  --callback-port 8118 \
  --client-id eKg8BebDnd09zxwy

그런 다음 Claude Code에서:

1. /mcp를 입력하면 1acre가 인증 필요 상태로 표시됩니다.

2. 로그인을 클릭합니다.

3. 브라우저에서 1acre 로그인 페이지가 열립니다(전화번호).

4. 전화번호를 입력 → SMS로 OTP 수신 → 코드 입력.

5. 동의 화면 → 허용.

6. 1acre가 ✓ 연결됨으로 전환됩니다.

이제 Claude에게 토지 관련 질문을 하세요: "1acre 토큰이 얼마나 남았나요?", "텔랑가나에는 어떤 구가 있나요?" 등.

빠른 시작 — Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 해당 OS의 동일 경로에 추가하세요:

{
  "mcpServers": {
    "1acre": {
      "url": "https://mcp.1acre.in/mcp",
      "transport": "http",
      "oauth": {
        "clientId": "eKg8BebDnd09zxwy",
        "callbackPort": 8118
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. MCP 서버 대화 상자에서 로그인합니다.

빠른 시작 — Cursor

Cursor의 MCP 구성은 ~/.cursor/mcp.json에 있습니다. 추가하세요:

{
  "mcpServers": {
    "1acre": {
      "url": "https://mcp.1acre.in/mcp"
    }
  }
}

Cursor는 첫 도구 호출 시 인증을 요청합니다.

더 자세한 예시는 examples/를 참조하세요.

인증

1acre MCP는 PKCE를 사용한 OAuth 2.1을 사용합니다. 로그인은 SMS 일회용 인증을 통한 전화번호 기반입니다(인도 전화번호에 대해 안전하고 DLT를 준수합니다).

• 전화번호가 신원이 됩니다.

• 1acre.in 계정이 먼저 있어야 합니다 — 사용할 전화번호로 1acre.in에 가입하세요. MCP는 전화번호를 일치시켜 Clerk 신원을 해당 계정으로 확인합니다.

• 세션은 인증 서버에서 관리되며, MCP 클라이언트가 토큰을 자동으로 갱신합니다.

OAuth 클라이언트 등록

대부분의 클라이언트는 자동으로 등록됩니다. 1acre의 OAuth 제공자는 https://clerk.1acre.in/oauth/register에서 RFC 7591 동적 클라이언트 등록을 지원합니다. DCR을 지원하는 MCP 클라이언트(Claude Code, Smithery 등)는 .well-known/oauth-authorization-server에서 이를 발견하고 첫 연결 시 자동으로 등록합니다. 별도로 할 일은 없으며, 위 빠른 시작의 --client-id 플래그는 클라이언트가 DCR을 지원하지 않는 경우에만 필요합니다.

hello@1acre.in으로 다음을 문의하세요:

1. MCP 클라이언트 이름 (예: "내부 에이전트 X")

2. 클라이언트가 사용할 정확한 콜백 URL

client_id를 받게 됩니다(공개 — 커밋해도 안전하며, PKCE 전용이므로 클라이언트 시크릿은 없습니다).

사용 가능한 주소

• MCP 엔드포인트: https://mcp.1acre.in/mcp

• 검색: https://mcp.1acre.in/.well-known/oauth-protected-resource

• 상태 확인: https://mcp.1acre.in/healthz

비용 및 제한

• 무료 도구 (탐색, 목록, 잔액 확인): 무제한

• 유료 도구 (보고서 생성, 필지 식별): 실행당 10토큰

• 속도 제한: OAuth 액세스 토큰당 분당 60회 요청

계정 등급별 토큰 허용량:

토큰은 적립 후 365일 후에 만료됩니다 — 이는 평생 허용량이 아닌 잔액입니다. 구매한 충전 팩은 등급 허용량 위에 쌓이므로 위 수치보다 잔액이 높은 것은 정상입니다. get_token_balance가 실제 사용 가능한 금액의 기준입니다.

더 높은 한도가 필요하면 hello@1acre.in으로 문의하세요.

지원

• 이슈: github.com/1acre-in/1acre-mcp/issues

• 이메일: hello@1acre.in

라이선스

MIT — LICENSE 참조.

서버 코드는 오픈소스가 아닙니다. 이 저장소는 클라이언트 측 구성 및 문서만 다룹니다.