API Docs

AI Agent MCP 導入

公開免 token 的 Docs MCP，讓 AI Agent 讀取最新 API 文件、OpenAPI 與 changelog。

Docs MCP 設定

Docs MCP 給 Codex、Claude Code、VS Code 與其他 AI Agent 讀取最新 API 文件。它公開免 token，只回文件、OpenAPI、catalog 與 changelog；不查 live data、不扣 API 點數、不寫 usage log。

https://app.ecpaydata.com.tw/api/mcp

加入 AI 工具

選擇使用的 client，複製對應設定。

claude mcp add ecpaydata-api-docs --scope user --transport http https://app.ecpaydata.com.tw/api/mcp

查看 REST API

進階：JSON-RPC smoke test

這組測試只讀文件，不需要 token，也不會產生用量紀錄。

MCP_URL="https://app.ecpaydata.com.tw/api/mcp" npm run mcp:smoke

curl -s "https://app.ecpaydata.com.tw/api/mcp" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

curl -s "https://app.ecpaydata.com.tw/api/mcp" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

curl -s "https://app.ecpaydata.com.tw/api/mcp" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"api.get_endpoint","arguments":{"path":"/api/public/trends/market"}}}'

Tools

Tool	用途
`docs.search`	搜尋公開文件、endpoint、參數與 response schema。
`docs.get_page`	讀取指定 Markdown 文件頁。
`api.list_endpoints`	列出 REST API endpoint 與 schema 摘要。
`api.get_endpoint`	讀取單一 REST API endpoint 文件與範例。
`api.get_openapi`	取得最新 OpenAPI 3.1 JSON。
`api.get_changelog`	取得文件與 API 變更紀錄。

資料查詢邊界

Docs MCP 不提供 `meta.categories`、`trends.market` 等資料查詢 tool。
舊資料 tool name 被呼叫時會回錯誤，提示改用對應 REST API。
Agent 要查 live data 時，請它依 REST API 文件寫程式，並從安全環境讀取 API Key。
不要把 API Key 貼進 prompt、文件、commit 或 issue comment。