# 接入你的 AI（MCP）

你的 AI（Claude Desktop、Cursor 或自己写的 agent）用你的 token 直连网关，工具清单按你的权限裁剪——接进 AI 不会让权限变大。

## 远程 MCP

在 MCP 客户端的配置里加一个服务器：URL 是本站的 `/mcp`，头里带你的 token。

1. 用渠道号 + 口令换一个 token（`POST /api/v1/auth/token`）。
2. 把右边的 JSON 贴进客户端配置，替换 token。
3. 连上后工具清单自动出现：能调什么取决于你的角色和仓白名单。

```json
{
  "mcpServers": {
    "ever-api": {
      "url": "https://connect.everugg.net.au/mcp",
      "headers": {
        "Authorization": "Bearer <你的token>"
      }
    }
  }
}
```

MCP 不按端点分工具：连上后工具清单按你的权限给出。这段配置对所有端点通用。

## 会敲命令的 AI：用 CLI

Claude Code、Cursor 这类编程助手本来就活在终端里：装上 `ever` 就能自己查库存、读文档，不用配 MCP。工具名和 MCP 一模一样（都来自能力目录）。

```bash
curl -fsSL https://connect.everugg.net.au/cli/install.sh | sh
ever login --sandbox
ever tools --json
```

文档本身也是给 AI 读的形状：每页有 Markdown，目录在 https://connect.everugg.net.au/llms.txt?lang=zh

## 权限

每个连接都用调用方自己的 token：先解出是谁、有哪些 scope，再裁剪工具；每次调用仍走网关（认证 + 授权 + 仓白名单 + 限流照常）。写操作永不自动执行。

## A2A（agent 对 agent）

对端 agent 可以按 A2A 协议直接对话： `POST https://connect.everugg.net.au/a2a` · https://connect.everugg.net.au/.well-known/agent-card.json

---
Markdown 源: https://connect.everugg.net.au/reference/mcp.md?lang=zh · 网页版: https://connect.everugg.net.au/reference?sec=mcp&lang=zh