コンテンツにスキップ

Getting Started

5 分で最初のリクエストを通す。料金詳細は pricing.md。

1. インストール

REST + MCP サーバー (Python)

pip install autonomath-mcp

SDK (pre-release、git 直)

pip install "git+https://github.com/shigetosidumeda-cyber/jpintel-mcp#subdirectory=sdk/python"
npm install "github:AutonoMath/autonomath-mcp#main" --prefix ./sdk/typescript

PyPI: autonomath-mcp v0.3.0 公開済。それまでは HTTP 直叩き or autonomath-mcp の MCP サーバー利用。

2. API key

匿名 (即時、登録不要)

API key 無しで叩くと 匿名 50 req/月 per IP (JST 月初リセット) として動作。

curl -X POST https://api.jpcite.com/v1/billing/checkout \
  -H "Content-Type: application/json" \
  -d '{
    "success_url": "https://jpcite.com/success.html?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://jpcite.com/pricing.html",
    "customer_email": "[email protected]"
  }'

返り値の url をブラウザで開いてカード登録。success_url 着地後に API key を取得:

curl -X POST https://api.jpcite.com/v1/billing/keys/from-checkout \
  -H "Content-Type: application/json" \
  -d '{"session_id": "cs_live_..."}'
# => {"api_key": "am_xxxxxxxxxxxxxxxx", "tier": "paid", "customer_id": "cus_..."}

API key は発行時 1 回だけ返る — 紛失時は Stripe Customer Portal で解約 → 再発行。

3. 最初のリクエスト

# 認証あり
curl -H "X-API-Key: am_xxxxxxxxxxxxxxxx" \
  "https://api.jpcite.com/v1/programs/search?q=IT導入"

# 匿名 (50 req/月 per IP)
curl "https://api.jpcite.com/v1/programs/search?q=IT導入&limit=5"

4. Python (requests)

import requests

r = requests.get(
    "https://api.jpcite.com/v1/programs/search",
    params={"q": "IT導入", "tier": ["S", "A"], "limit": 5},
    headers={"X-API-Key": "am_xxxxxxxxxxxxxxxx"},
)
r.raise_for_status()
print(r.json()["total"], "results")

5. Node.js (fetch)

const url = new URL("https://api.jpcite.com/v1/programs/search");
url.searchParams.set("q", "IT導入");
url.searchParams.append("tier", "S");
url.searchParams.append("tier", "A");

const res = await fetch(url, { headers: { "X-API-Key": "am_xxxxxxxxxxxxxxxx" } });
const data = await res.json();
console.log(`${data.total} results`);

6. MCP (Claude Desktop)

Protocol: 2025-06-18。~/Library/Application Support/Claude/claude_desktop_config.json (macOS) を編集:

{
  "mcpServers": {
    "autonomath": {
      "command": "uvx",
      "args": ["autonomath-mcp"]
    }
  }
}
  • uv 未導入なら brew install uv か pip install uv
  • pip install autonomath-mcp 済みなら "command": "autonomath-mcp"
  • ワンクリック: autonomath-mcp.mcpb を Claude Desktop で開く
  • 再起動後、89 ツール at default gates が有効。Cursor / Gemini / ChatGPT (MCP 対応版) も同設定で動作

ツール一覧: mcp-tools.md。

7. 5 秒スモークテスト

curl https://api.jpcite.com/healthz   # => {"status":"ok"}
curl https://api.jpcite.com/v1/meta   # => {"total_programs": ..., "tier_counts": {...}}

両方 200 が返れば導入成功。/healthz と /v1/meta は課金対象外。

次は