# GeneDai Match · Agent 接入

服务地址：https://match.genedai.me

## 远程 MCP（推荐）

在支持 Streamable HTTP 和 OAuth 的客户端中添加：

```json
{"mcpServers":{"genedai-match":{"url":"https://match.genedai.me/mcp"}}}
```

浏览器将打开邮箱登录与应用授权页。本人确认后，客户端获得独立、可撤销的 Agent 授权。采用 OAuth 2.1 风格授权码流程、S256 PKCE、动态客户端注册；访问令牌 1 小时，刷新令牌 30 天并轮换。默认 scope 为 genedai。具体客户端字段以其界面为准。

## 17 个工具

- `genedai_health`：连接检查。
- `genedai_scenarios`：五场景角色与结构化选项。
- `genedai_cards`：读取本人场景名片、状态和版本。
- `genedai_card_save`：新建 / 替换私密名片；更新需 cardId 与 version。修改会暂停发现并清除分享。
- `genedai_profile_get` / `genedai_profile_import`：本人账户称呼、私密联系方式；不要在账户层存储场景偏好。
- `genedai_sharing_request`：返回本人发布页面。
- `genedai_discovery`：按 cardId（可选）获取双向相容结果与实际原因。
- `genedai_connections`：本人连接、方案和真实授权状态。
- `genedai_group_create`：用 cardId 和 candidateId 发起介绍，对方本人接受后激活。
- `genedai_chat` / `genedai_messages`：本人的私密 AI 协调对话。
- `genedai_proposal_create`：草拟待双方确认的安排。
- `genedai_confirmation_request`：返回具体方案的本人确认链接。
- `genedai_photo_request`：仅恋爱连接可请求照片。
- `genedai_contact_request`：请求联系方式交换，双方确认后才开放。
- `genedai_settings_link`：撤销、提醒和数据管理入口。

## 名片示例（仅演示结构）

```json
{"scenario":"coffee","role":"peer","data":{"displayName":"用户明确提供的称呼","headline":"交流独立开发与产品验证","bio":"用户授权的背景","cities":["上海"],"topics":["独立开发"],"offer":["产品设计"],"seek":["产品验证"],"remote":true,"adult":true}}
```

年龄确认必须来自本人，不能由 Agent 猜测。此示例不可直接当作真实用户事实。资金与薪资范围用万元：CNY 或 USD；招聘范围是税前年薪；不会跨币种自动换算。

## 本地无依赖客户端

需要 Node.js 22+。下载 `/client/latest.json` 中的 ZIP 并核对 SHA-256。不要把令牌、配置文件或登录验证码粘贴到聊天、日志或 Git。

```sh
node cli.mjs onboard --label "My Agent"
node cli.mjs status
node cli.mjs cards
node cli.mjs card-save --file /private/card.json
node cli.mjs discovery
node cli.mjs introduce TARGET_CARD_ID --card OWN_CARD_ID
node mcp-server.mjs
```

本地客户端配置保存在 `~/.config/genedai-match/client.json`，权限 0600，与 GeneDai Chat 分开。首次连接码有效 15 分钟；该连接令牌有效 90 天，可在设置撤销。所有代码保留所有权，下载包不代表开源授权。

## 授权边界

Agent 可读取本人私密名片、保存草稿、发现、发起介绍、草拟安排；不可代替本人发布、接受介绍、确认安排、授权照片 / 联系方式或发送双方直接聊天。本人可随时撤销单个 Agent。场景之间不合并敏感资料。日程只保存可交流时段，不读写外部日历。