介绍
# Civic Nexus MCP Bridge
> **⚠️ 免责声明：使用风险自负。如需官方文档，请访问 [docs.civic.com](https://docs.civic.com)。**
连接到 [Civic Nexus](https://nexus.civic.com) 以获取 100 多种集成，包括 Gmail、PostgreSQL、MongoDB、Box 等。
## 设置
### 1. 获取您的 Nexus 凭证
1. 前往 [nexus.civic.com](https://nexus.civic.com) 并登录 2. 从您的个人资料设置中获取 **MCP URL** 和 **访问令牌**
### 2. 在 OpenClaw 中配置
添加到 `~/.openclaw/openclaw.json`：
```json { "skills": { "entries": { "civic-nexus": { "enabled": true, "env": { "NEXUS_URL": "https://nexus.civic.com/hub/mcp?accountId=YOUR_ACCOUNT_ID&profile=YOUR_PROFILE", "NEXUS_TOKEN": "your-access-token" } } } } } ```
### 3. （可选）配置 mcporter
如果您已安装 mcporter（`npm install -g mcporter`），请添加到 `~/.openclaw/workspace/config/mcporter.json`：
```json { "mcpServers": { "nexus": { "baseUrl": "https://nexus.civic.com/hub/mcp?accountId=YOUR_ACCOUNT_ID&profile=YOUR_PROFILE", "headers": { "Authorization": "Bearer YOUR_TOKEN", "User-Agent": "openclaw/1.0.0" } } } } ```
## 代理指令
当用户要求通过 Nexus 与外部服务交互时，首先尝试使用 mcporter。如果失败，则回退到 TypeScript 脚本。
### 使用 mcporter
```bash # List tools mcporter list nexus
# Search tools mcporter list nexus | grep gmail
# Call a tool mcporter call 'nexus.google-gmail-search_gmail_messages(query: "is:unread")' ```
### 回退：TypeScript 脚本
```bash # List tools npx tsx {baseDir}/nexus-tool-runner.ts --list
# Search tools npx tsx {baseDir}/nexus-tool-runner.ts --search gmail
# Get tool schema npx tsx {baseDir}/nexus-tool-runner.ts --schema google-gmail-search_gmail_messages
# Call a tool npx tsx {baseDir}/nexus-tool-runner.ts --call google-gmail-search_gmail_messages --args '{"query": "is:unread"}' ```
### 授权流程
某些工具在首次使用时需要 OAuth。当您看到授权 URL 时：
1. 向用户显示该 URL 2. 用户授权后，继续执行： ```bash # mcporter mcporter call 'nexus.continue_job(jobId: "JOB_ID")'
# script npx tsx {baseDir}/nexus-tool-runner.ts --call continue_job --args '{"job_id": "JOB_ID"}' ```
## 注意事项
- API 调用可能需要 10-15 秒（服务器端延迟） - 令牌约 30 天后过期 — 如需要，请从 Nexus 重新生成 - Gmail 批量请求每次调用限制为 5-25 条消息
---