Tillpad MCP

에이전트 작업을 위한 제한된 저장소 및 검색.

Tillpad는 에이전트에게 네임스페이스 기반 키-값 저장소, 파일 업로드 + 의미론적 검색, 예산 인식 사용량 측정, 그리고 작업이 완료되면 서명된 영수증과 함께 삭제되는 run 키를 제공합니다.

라이브 엔드포인트: https://tillpad.cnrcode.com/mcp

이 저장소는 디렉터리 크롤러를 위한 공개 카탈로그 및 스키마 스텁입니다. 호스팅 서버가 아닙니다. Tillpad API 키를 사용하여 MCP 클라이언트를 위의 라이브 URL에 연결하세요. 이 저장소의 TypeScript를 실행해도 아무것도 저장하거나 검색하지 않습니다.

에이전트 가이드: 검색 URL, 인증 및 MCP 연결 스니펫은 AGENTS.md를 참조하세요.

API 키 받기

제로 휴먼 (에이전트)

1. POST https://tillpad.cnrcode.com/api/agents/bootstrap를 { "email": "agent@example.com" }과 함께 호출 → bootstrapToken (발신 메일 없음).

2. Authorization: Bearer <bootstrapToken> 및 선택적 { "sku": "pro_prepaid_30d" }와 함께 POST https://tillpad.cnrcode.com/api/billing/machine-pay 호출.

3. Stripe MPP 결제 완료 ($9.00 / 30일) → 응답에 secret (tp_…) 및 planPeriodEnd 포함.

scratchpad.txt 및 llms-full.txt를 참조하세요. 법적 고지: 이용약관.

휴먼 경로

1. tillpad.cnrcode.com을 열고 계정을 만드세요.

2. 요금제에서 Tillpad Pro를 구독한 다음 대시보드에서 API 키를 발급하세요. 시크릿은 tp_로 시작합니다.

3. 지속적인 액세스에는 account 키를, 작업이 만료되고 삭제되어야 할 때는 run 키를 사용하세요.

실제 키를 커밋하지 마세요. 구성 파일에서는 tp_… 플레이스홀더를 사용하세요.

Related MCP server: ContextKeep

클라이언트 연결

전송 방식은 Streamable HTTP입니다. 모든 요청에 Authorization: Bearer tp_…를 보내세요.

Cursor

사용자 또는 프로젝트 MCP 구성:

{
  "mcpServers": {
    "tillpad": {
      "url": "https://tillpad.cnrcode.com/mcp",
      "headers": {
        "Authorization": "Bearer tp_…"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "tillpad": {
      "command": "npx",
      "args": ["mcp-remote", "https://tillpad.cnrcode.com/mcp", "--header", "Authorization: Bearer tp_…"]
    }
  }
}

일반 원격 MCP

{
  "url": "https://tillpad.cnrcode.com/mcp",
  "headers": {
    "Authorization": "Bearer tp_…"
  }
}

제품 호스트의 검색 매니페스트:

• /.well-known/mcp.json

• /.well-known/mcp/server.json

• /llms.txt

도구

src/server.ts의 스키마는 호스팅 서버와 일치합니다.

일반적인 에이전트 루프

1. 대시보드에서 run 키를 발급하세요 (전용 네임스페이스, TTL, 선택적 작업 예산).

2. kvp_put 및/또는 file_upload로 작업 상태를 저장하세요.

3. kvp_get / kvp_list 및 rag_search로 검색하세요.

4. run_finish를 호출하여 run 네임스페이스를 삭제하고 서명된 영수증을 보관하세요.

대규모 인덱스 작업 전에 budget_estimate를 사용하세요. budget_get / usage_get은 해당 기간에 남은 용량을 표시합니다.

인증 및 오류

• 401 — Authorization: Bearer tp_… 누락 또는 잘못됨

• 402 / 429 — 요금제 또는 할당량. JSON에 code, status, actions, budget 포함

  • actions[].type: "checkout" — 정기 휴먼 구독을 위한 호스팅 Stripe Checkout URL

  • actions[].type: "machine_pay" — 에이전트 선불 Pro (30/90일) 또는 Stripe MPP를 통한 충전 SKU; 기본 sku pro_prepaid_30d ($9.00)

이는 Stripe Machine Payments Protocol이며, ChatGPT Instant Checkout / ACP가 아닙니다.

제품 문서

• 앱: tillpad.cnrcode.com

• 문서: tillpad.cnrcode.com/docs

• 스크래치패드: tillpad.cnrcode.com/docs/scratchpad

• OpenAPI: tillpad.cnrcode.com/openapi.json

Tillpad 제품(Worker, 결제, 스토리지)은 클로즈드 소스입니다. 이 카탈로그는 MIT 라이선스이므로 디렉터리에서 도구와 설치 스니펫을 나열할 수 있습니다.

디렉터리 등록

레지스트리 이름: com.cnrcode/tillpad (cnrcode.com을 통한 도메인 네임스페이스).

1. https://cnrcode.com/.well-known/mcp-registry-auth가 배포되었는지 확인하세요 (cnrcode-site 저장소).

2. GitHub 저장소 시크릿 **MCP_PRIVATE_KEY**를 설정하세요 (hex; cnrcode-site 키 생성 스크립트 참조).

3. 버전 태그를 푸시하여 GitHub Actions가 server.json을 공식 MCP 레지스트리에 게시하도록 하세요:

git tag v0.1.1
git push origin v0.1.1

4. 선택적으로 https://github.com/number1101/tillpad-mcp를 mcp.directory/submit에 제출하세요.

Glama

이 저장소에는 stdio 카탈로그 스텁(src/main.ts)이 포함되어 있어 Glama가 컨테이너를 빌드하고, 프로세스를 시작하고, 17개의 도구 정의를 검사할 수 있습니다. 이 스텁은 스토리지나 결제를 구현하지 않습니다. 클라이언트는 여전히 위의 호스팅 엔드포인트에 연결합니다.

등록: glama.ai/mcp/servers/number1101/tillpad-mcp

glama.json을 통해 클레임한 후 Dockerfile 관리 페이지를 구성하세요:

Glama는 해당 양식에서 자체 Dockerfile을 생성합니다. 저장소의 Dockerfile은 로컬 스모크 테스트 전용입니다.

점수 배지 (awesome-mcp-servers 및 유사 목록용):

[![number1101/tillpad-mcp MCP server](https://glama.ai/mcp/servers/number1101/tillpad-mcp/badges/score.svg)](https://glama.ai/mcp/servers/number1101/tillpad-mcp)

로컬 검증:

npm ci && npm run build && npm start   # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stub

전체 단계별 가이드 (클레임, 관리자 Dockerfile, 릴리스, awesome-mcp PR): docs/glama-release.md.

라이선스

MIT — 카탈로그, 문서 및 스키마 스텁 전용.