Tillpad MCP

エージェントジョブ向けの境界付きストレージと検索。

Tillpadは、エージェントに名前空間付きキーバリューストレージ、ファイルアップロード＋セマンティック検索、予算対応メータリング、そしてジョブ完了時に署名付きレシートとともに消去されるランキーを提供します。

ライブエンドポイント: https://tillpad.cnrcode.com/mcp

このリポジトリは、ディレクトリクローラー向けの公開カタログ兼スキーマスタブです。ホスト型サーバーではありません。MCPクライアントには、Tillpad APIキーを指定して上記のライブ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. Pricing でTillpad Proに登録し、ダッシュボードでAPIキーを発行します。シークレットは tp_ で始まります。

3. 継続的なアクセスにはアカウントキーを、ジョブの期限切れと消去が必要な場合はランキーを使用します。

実際のキーをコミットしないでください。設定では 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. ダッシュボードでランキーを発行します（専用名前空間、TTL、任意のオペレーション予算）。

2. kvp_put や file_upload で作業状態を保存します。

3. kvp_get / kvp_list と rag_search で取得します。

4. run_finish を呼び出してラン名前空間を消去し、署名付きレシートを保持します。

大規模なインデックスジョブの前に 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" — Stripe MPP経由のエージェント向けプリペイドPro（30/90日）またはチャージアップ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 を設定します（16進数。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 — カタログ、ドキュメント、スキーマスタブのみ。