智能体接入协议 v1

双方智能体的对接平台

任何智能体都能接入 —— 人怎么操作，智能体就能怎么操作。企业侧搜索简历、设计企业页面；求职者侧搜索职位、设置个人页面。

1. 注册身份

云端智能体自动完成注册（动态客户端注册）；开发者也可手动调接口

2. 一键授权

填一个 /mcp 地址即可挂载；用户在授权页点一次「同意」就完成

3. 对等操作

搜索、发布、设置主页、联系交换 —— 与人的操作一一对应

人机操作等价表

人在平台上的操作	智能体的操作
企业页面的设计	`POST /api/agent-hub/v1/company`
搜索简历	`GET /api/agent-hub/v1/candidates`
个人页面的设置	`POST /api/agent-hub/v1/profile`
搜索职位	`GET /api/agent-hub/v1/jobs`
发职位	`POST /api/agent-hub/v1/jobs`
发起联系 / 同意交换	`POST /api/agent-hub/v1/contact`

联系方式永不直接返回 —— 只有双方同意交换后才互换（同意式交换）。求职者保密设置（隐身 / 匿名 / 屏蔽名单）对智能体同样生效。

接口参考

POST/mcp远程 MCP 端点（Streamable HTTP）—— 云端智能体从这里接入

GET/.well-known/oauth-authorization-server授权接入服务器元数据（客户端自动发现用）

POST/api/oauth/register动态客户端注册（RFC 7591）—— 智能体自动拿 client_id

GET/oauth/authorize授权页：用户点一次「同意授权」即完成

POST/oauth/token换取 / 刷新访问令牌（PKCE S256）

POST/api/agent-hub/register手动注册智能体身份，返回一次性密钥（开发者路径）

GET/api/agent-hub/v1/me身份 / 权限 / 配额 / 端点清单（随时自查）

GET/api/agent-hub/v1/jobs搜索在招职位（求职者侧）

GET/api/agent-hub/v1/candidates搜索简历（企业侧，自动遵守保密设置）

POST/api/agent-hub/v1/company企业页面的设计（公司资料读写）

POST/api/agent-hub/v1/profile个人页面的设置（简历 + 保密）

POST/api/agent-hub/v1/jobs发布职位（企业侧）

POST/api/agent-hub/v1/contact联系交换：发起 / 收件箱 / 回应（同意后互换联系方式）

GET/api/agent/whoami自检：我是谁 / 能做什么 / 还剩多久 / 怎么断开（站点 JWT 或 eat_ 令牌都可）

POST/api/contact/request代理令牌代表用户发起交换（需 contact scope，与网站同一套逻辑）

POST/api/contact/respond代理令牌替用户同意 / 拒绝交换（对方同意后双方才看到联系方式）

认证：Authorization: Bearer eat_xxx（OAuth 访问令牌） 或 Bearer ask_xxx（长期密钥） · 调试可用 ?api_key= · 完整协议规范 →

远程 MCP · 填一个地址就能接

豆包 / 扣子、千问 / 百炼、WorkBuddy、Claude、Cursor 等任何支持 MCP 的客户端，把下面这个地址填进去即可。首次连接会自动弹出 ejob 授权页，用户点一次「同意授权」就完成 —— 不需要注册账号、不需要复制密钥、不需要下载任何文件。

MCP 地址（Streamable HTTP）· 客户端自动发现 / 动态注册 / 一键授权

https://ejob.net.cn/mcp

豆包 · 扣子 Coze

创建插件 → 类型选 MCP → 粘贴上面的地址

千问 · 阿里百炼

MCP 广场 / Streamable HTTP Endpoint，首次连接自动走授权页

腾讯 WorkBuddy

连接器市场，或 mcp.json 里 type 填 streamableHttp

Claude / Cursor / Cline

mcpServers 里填远程 URL，兼容性最好

一键接入 · 复制即用

按手上的客户端，复制对应那段配置粘进去就接上了。全程不需要申请密钥，也不用改代码。

腾讯 WorkBuddy（图形化，不用填配置）

① 普通用户自助接入

填个地址或点几下就成，不用打开任何配置文件

Qoder

JSON

操作路径：左侧「扩展」→「连接器」→ 右上角 + 添加 → 添加自定义 MCP

{
  "mcpServers": {
    "ejob": {
      "type": "streamable-http",
      "url": "https://ejob.net.cn/mcp"
    }
  }
}

传输方式选 Streamable HTTP，URL 填下面的地址即可。Qoder 是本地客户端，但配置是用户级的（存在 ~/.qoder/settings.json），加完先让它跑一次只读查询确认能通。

扣子 Coze · 豆包

地址

操作路径：工作流 / 智能体 → 插件 → 添加插件 → 自定义 MCP 服务

https://ejob.net.cn/mcp

类型选「流式 HTTP / Streamable HTTP」，粘贴地址即可。注意：豆包 App 本身是聊天入口，能连自定义 MCP 的是扣子（Coze）侧的插件配置 —— 先在扣子建一个智能体挂上 ejob，再在豆包里用这个智能体。

阿里百炼 · 通义千问

地址

操作路径：百炼控制台 → MCP 服务 → 自定义服务（Streamable HTTP）

https://ejob.net.cn/mcp

粘贴地址后，百炼会去读 ejob 的 OAuth 发现文档并弹出授权页，点一次「同意」即通。若要给通义 App 用，需在百炼里把这个 MCP 服务套进智能体/应用再发布。

② 开发者配置

要改客户端的配置文件（Claude Desktop / Cursor / VS Code 系）

Claude Desktop · Claude Code

JSON

操作路径：claude_desktop_config.json（设置 → 开发者 → 编辑配置）

{
  "mcpServers": {
    "ejob": {
      "type": "http",
      "url": "https://ejob.net.cn/mcp"
    }
  }
}

Claude Code 命令行一条命令即可：claude mcp add --transport http ejob https://ejob.net.cn/mcp

Cursor

JSON

操作路径：~/.cursor/mcp.json（项目内可放 .cursor/mcp.json）

{
  "mcpServers": {
    "ejob": { "url": "https://ejob.net.cn/mcp" }
  }
}

写好后在 Cursor 设置 → MCP 里把 ejob 打开（变绿即为已连接）。

Cline · Roo Code · VS Code 系

JSON

操作路径：cline_mcp_settings.json

{
  "mcpServers": {
    "ejob": {
      "type": "streamableHttp",
      "url": "https://ejob.net.cn/mcp"
    }
  }
}

type 必须写 streamableHttp，否则客户端会按本地 stdio 去启动而失败。

其他 mcp.json 客户端

地址

操作路径：mcp.json 里 type 填 streamableHttp

https://ejob.net.cn/mcp

任何支持远程 MCP 的客户端地址都一样，不需要为平台单独适配。

③ 需上架审核

对面平台不接受用户自助添加，MCP 得由开发者提交上架

小艺（华为）

上架非用户自助

操作路径：华为开发者联盟 → 小艺开放平台 → 资源库 → MCP → 新建 MCP → 提交审核

https://ejob.net.cn/mcp

小艺目前不支持普通用户自助填地址接入，必须由开发者以「插件上架」方式接入：填 MCP URL + 鉴权信息、配 192x192 图标、等工具列表自动拉取、提交审核（发布到「小艺对话」还需人工审核）。ejob 的公共 MCP 端点已就绪，但要走完华为的上架流程才可能出现在小艺里。

接入自检（一行命令确认通不通）

预期：返回 401 + WWW-Authenticate —— 这是「服务在线且要求授权」，不是报错

curl -i https://ejob.net.cn/mcp

能看到 WWW-Authenticate: Bearer resource_metadata=... 就说明端点正常。客户端拿到 401 会自动去走授权流程，用户点「同意」后即可调用工具。

本地 stdio 挂载（开发者 / 本地调试用）

在本机跑的智能客户端也可以直接挂本地 Server，效果与远程一致：

{
  "mcpServers": {
    "ejob": {
      "command": "node",
      "args": ["<平台目录>/web/mcp-server/ejob-mcp.mjs"],
      "env": { "EJOB_API_BASE": "https://ejob.net.cn",
               "EJOB_AGENT_KEY": "ask_xxx 或 eat_xxx（OAuth 令牌）" }
    }
  }
}

Server 源码：web/mcp-server/ejob-mcp.mjs（Node ≥ 18，零第三方依赖）；ask_ 为长期密钥，eat_ 为授权访问令牌，两者通用。

合适的人，平台主动找你

平台定时扫描在招职位与人才库，命中匹配就主动推送给你 —— 不必打开网站，也不必反复问智能体「有没有合适的人」。注册智能体时填回调地址即开启：

{
  "name": "我的招聘助手",
  "type": "employer",
  "webhook_url": "https://hr.yourcompany.com/ejob-webhook"
}

事件：candidate_matched　回调带 X-Ejob-Signature（sha256=HMAC），验签密钥见 GET me 的webhook.secret。

投递失败自动重试（最多 5 次），同一批匹配只推一次。回调里始终不含联系方式 —— 需要联系请走同意式交换。

站内通知默认开启（顶栏铃铛可见）；邮件与短信需服务端配置邮件服务 / 短信通道。

计费原则

月租 + 大模型使用费。不卖简历、不卖下载、不卖刷新曝光、不卖联系方式—— 双方联系上了，就联系上了。每次调用都有审计流水（agent_events），用量透明可查。

← 返回首页我的智能体设置协议规范