# OAuth MCP 接入

本地授权、PKCE、MCP 固定样本、令牌轮换与撤销；连接前看清权限。

## 在本机连接

网站同时提供本地授权服务器与受保护的 MCP 端点。本机流程无需域名或第三方登录账号。

MCP: https://datanavoapi.com/api/mcp

Authorization server metadata: https://datanavoapi.com/.well-known/oauth-authorization-server

Protected resource metadata: https://datanavoapi.com/.well-known/oauth-protected-resource/api/mcp

## 授权、测试与撤销

打开 Agent 连接，使用内置验收器或登记带精确本机回调地址的公共客户端。登录后核对应用、回调和权限，再同意或拒绝。S256 PKCE 绑定一次性授权码；验收器交换授权码前检查 state 和 issuer。

[管理 Agent 连接](https://datanavoapi.com/account/agent-connections/)

## 权限边界

`mcp:read`: find, describe. `mcp:demo`: call, read_more; requires mcp:read.

OAuth 工具只读取公开目录和固定虚构样本，不开放账户记录、不扣客户 TEST 点数、不请求供应商。原有 stdio 和独立 Key HTTP 接入继续保留 demo、simulated 与 live 只读模式。

## 凭证生命周期

访问令牌有效期 10 分钟。刷新令牌轮换使用，重复使用已消费的刷新令牌会撤销对应授权族。撤销应用或授权后，已有 MCP 会话的后续请求同样失效。网页验收器仅在内存保留令牌，刷新后需重新连接。

## 传输与恢复

此端点固定支持 2025-06-18 Streamable HTTP 握手：initialize、initialized、tools/list、tools/call。返回 JSON，不提供 SSE 或自动重试。会话失效后重新连接，Bearer 令牌不要放入 URL、提示词或工具参数。

## 连接云端客户端之前

云端客户端无法访问本机回环地址。公网接入需要稳定 HTTPS 域名、部署的授权服务、注册的回调地址、生产存储与限流；这些部署和兼容性验证尚待完成。真实 API、支付及外部邮件保持关闭。

[MCP 总览](https://datanavoapi.com/mcp/)

[MCP authorization specification](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization)
