CardDex

AI 助理連接指南（MCP）

讓你的 AI 助理擁有 CardDex 帳號的能力 — 查卡價、發求購單、刊登商品，全部以你的身分代勞。

這是什麼？

CardDex 提供 MCP（Model Context Protocol）伺服器，讓 Claude 等 AI 助理直接連上 CardDex。 連接後，你可以用一句話請 AI 助理「幫我查噴火龍 ex 的行情」「幫我發一張收購文」「把這張卡刊登上架」， AI 助理會透過你授權的權杖（Token）以你的身分完成操作。

支援的工具

  • ✓Claude Code（CLI / 桌面版）— 官方支援，下方有一行指令可直接複製。
  • ✓其他支援「HTTP transport + 自訂 header」的 MCP 客戶端（如 Cursor 等開發工具）。
  • ✗claude.ai 網頁版／手機 App 的 Connector 尚未支援 — 它需要 OAuth 登入流程，我們還在開發中。請先使用上述工具連接。

第一步：建立你的權杖（PAT）

  1. 登入後前往 帳號設定 的「API tokens」區塊，輸入名稱（例如 my-agent）按「建立」。
  2. 權杖明碼只會顯示一次，請立刻複製保存。外洩時隨時可在同頁撤銷。
  3. 新建立的權杖具備兩種權限：wanted:write（發布／管理求購單）與 listing:write（刊登／管理商品）。查價、搜尋等讀取操作不需要額外權限。

注意：2026 年 6 月 2 日前建立的舊權杖只有求購權限，無法使用刊登工具 — 請撤銷後重新建立一顆即可同時取得兩種權限。

第二步：連接

Endpoint：https://mcp.my-card-dex.com/mcp/ （結尾的斜線是必要的）

Claude Code 一行指令（把 <PAT> 換成你的權杖）：

claude mcp add --transport http cardex https://mcp.my-card-dex.com/mcp/ --header "Authorization: Bearer <PAT>"

其他 MCP 客戶端的通用設定（JSON）：

{
  "mcpServers": {
    "cardex": {
      "type": "http",
      "url": "https://mcp.my-card-dex.com/mcp/",
      "headers": { "Authorization": "Bearer <PAT>" }
    }
  }
}

AI 助理能做什麼？（15 個工具）

🔍 發現（不需權限）

  • search_cards — 搜尋卡牌圖鑑
  • get_card — 卡牌詳細資料
  • get_market_price — 查市場行情
  • suggest_price — 建議定價
  • browse_listings — 瀏覽刊登
  • browse_wanted_posts — 瀏覽求購

📋 我的資料（不需權限）

  • list_my_wanted_posts — 我的求購單
  • list_my_listings — 我的刊登

🙋 求購（需 wanted:write）

  • create_wanted_post — 發布求購單
  • attach_wanted_post_image — 附加圖片
  • update_wanted_post — 修改求購單
  • close_wanted_post — 關閉求購單

🏷️ 出售（需 listing:write）

  • create_listing — 刊登商品
  • attach_listing_image — 附加圖片
  • update_listing — 修改刊登

「發現」與「我的資料」屬讀取操作，任何有效權杖都能使用；寫入操作需要對應權限（新權杖預設兩種都有）。

安全邊界

我們刻意限制了 AI 助理的能力範圍。透過 MCP 連接的助理無法：

  • 出價競標（拍賣出價必須本人操作）
  • 付款或進行任何金流操作
  • 存取錢包與交易紀錄
  • 讀取或發送聊天訊息
  • 執行任何管理員操作

權杖也不能用來登入網站或呼叫一般 API — 它只對 MCP 工具有效。覺得有異常？到 帳號設定 一鍵撤銷即可。