开始接入
通过 Streamable HTTP MCP 将 Asklear 接入你的 Agent，并验证第一次认证工具调用。
Markdown文档 ID:
agent.getting_started接入前
- Dashboard 消息包含准确的 MCP URL 和有效访问密钥，直接用它们配置 asklear；地址以 /mcp 结尾，非本地环境使用 HTTPS。Key 仅用于 MCP 配置。
- 创建任何配置前，先检查当前客户端是否已有名为 asklear 的服务。URL 相同时直接复用并使用接入消息提供的凭据，不得重复创建服务；URL 不同时停止并让用户确认后再修改。
- 公共示例使用 URL 和 Key 占位符只是因为它们属于共享文档。用当前接入消息中已有的 URL 和 Key 替换占位符。如果客户端要求 Agent 无法代办的原生信任、发布、重启或确认动作，准确说明剩余动作。
- 正常使用只需遵循 MCP 初始化说明；仅当客户端没有展示这些说明或能力错误需要恢复时，才查看 /docs/agent/index.md。
必装组件
- Asklear MCP（必装）：通过当前客户端有文档支持的 MCP 或连接器入口，安装一个名为 asklear 的远程 Streamable HTTP 服务。
完成标准
- 通过列出 MCP 工具确认 asklear 服务已经启用。
- 完成一次经过认证的 MCP 操作。优先执行用户的首个真实搜索或查询并报告数据截止时间；尚无问题时调用 connection_status 并报告连接状态。
以后如何查数
- 按 MCP 初始化路由直接查询；仅在方法不明确或能力错误需要恢复时查看 /docs/agent/workflow.md。
- 每次认证后的查询或搜索响应都是实际执行范围和能力版本的运行时事实；仅在契约错误后用 describe 恢复细节。
Codex
官方文档Codex CLI、IDE 扩展和 ChatGPT 桌面应用共享 MCP 配置。直接把接入消息中的 URL 和 Key 配置为该服务器的静态 HTTP 请求头。
配置步骤
- 使用接入消息中的 URL 和 Key 将服务器加入 ~/.codex/config.toml。只有用户明确要求项目级配置时才使用 .codex/config.toml。
- 保存配置后重启应用或 IDE 扩展。
需要你操作
- 桌面应用中点击 Restart，IDE 中点击 Restart extension；使用 Codex CLI 时重新启动终端会话。
- 如果服务器配置在项目级 .codex/config.toml 中，请在 Codex 提示时信任该项目。
配置示例
[mcp_servers.asklear]
url = "<YOUR_API_BASE_URL>/mcp"
http_headers = { Authorization = "Bearer <YOUR_ASKLEAR_API_KEY>" }
Claude Code
官方文档Claude Code 支持远程 HTTP MCP，并可在 .mcp.json 中直接配置 Authorization 请求头。
配置步骤
- 使用接入消息中的 URL 和 Key 添加以下 .mcp.json，或把同一服务器配置改为 user/local scope。
- 在 Claude Code 中打开 /mcp，确认 asklear 已连接。
需要你操作
- 使用项目级 .mcp.json 时，请在 Claude Code 弹出的服务器审批提示中允许 asklear。
- 继续前打开 /mcp，确认 asklear 状态为 connected 且能看到工具。
配置示例
{
"mcpServers": {
"asklear": {
"type": "http",
"url": "<YOUR_API_BASE_URL>/mcp",
"headers": {
"Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
}
}
}
}
Manus
官方文档Manus 使用账户级 Custom MCP Server Connector，并可直接通过 JSON 导入完整的 Asklear 配置。
配置步骤
- 打开 Settings → Integrations，找到 MCP connections，然后选择 Create → Import by JSON。
- 粘贴下方 JSON，然后点击 Import。
- 不要修改 Manus 沙箱里的 ~/.mcp/servers.json 或其他猜测出来的配置文件。
需要你操作
- 导入后，如果 Manus 显示 Test Connection，请运行连接测试。
- 确认测试成功，并且 Manus 已获取 Asklear 的可用工具。
配置示例
{
"mcpServers": {
"asklear": {
"url": "<YOUR_API_BASE_URL>/mcp",
"headers": {
"Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
}
}
}
}
OpenClaw
官方文档OpenClaw 将外部 MCP 服务器保存在 mcp.servers 下，并要求明确使用 streamable-http。使用接入消息中已有的 URL 和 Key 配置 Control UI 或本地 registry。
配置步骤
- 通过 Control UI 的 /settings/mcp 或 MCP 配置编辑器加入以下配置，然后 Save & Publish。
- Agent 自行用接入消息中的 URL 和 Key 替换公共示例占位符。OpenClaw 原生 outbound MCP 请求头不会展开 ${ENV_VAR} 占位符。
- 不得将填写密钥后的配置提交或粘贴到代码仓库、Skill、截图或无关对话中。
- 修改配置后，重载或重启持有 MCP 客户端的运行时。
需要你操作
- 确认 asklear 服务器已启用，然后点击 Save & Publish；只点击 Save 不会把变更应用到 Gateway。
- 执行 openclaw mcp reload、发布 Gateway 配置，或重启持有 MCP 客户端的进程。
配置示例
{
"mcp": {
"servers": {
"asklear": {
"url": "<YOUR_API_BASE_URL>/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
}
}
}
}
}
Hermes
官方文档Hermes 从 ~/.hermes/config.yaml 读取远程 HTTP MCP 及其 Authorization 请求头。
配置步骤
- 使用接入消息中的 URL 和 Key，将以下服务器加入 ~/.hermes/config.yaml 的 mcp_servers 下。
- 启动 Hermes；如果会话已在运行，保存后执行 /reload-mcp。
需要你操作
- 修改配置后重启 Hermes，或执行 /reload-mcp。
- 如果 Hermes 显示 MCP 重载确认，请点击允许。
配置示例
mcp_servers:
asklear:
url: "<YOUR_API_BASE_URL>/mcp"
headers:
Authorization: "Bearer <YOUR_ASKLEAR_API_KEY>"
WorkBuddy
官方文档WorkBuddy 通过连接器管理开放自定义 MCP 服务。其公开连接器文档没有承诺固定的远程认证表单，因此只能使用当前安装版本实际提供的字段。
配置步骤
- 从左侧导航打开「连接器」，再点击右上角的「自定义连接器」。
- 如果当前「自定义连接器」对话框支持远程 MCP JSON，或支持 URL 与请求头，则填写下方标准值；不要改成本地 stdio 命令，也不要猜测不存在的字段。
- 如果界面没有这些远程字段，停止并报告当前 WorkBuddy 版本无法安全接入 Asklear；字段可用时再保存并启用连接器。
需要你操作
- 如果写入配置时 WorkBuddy 正在运行，请完全退出并重新打开。
- 打开「连接器 → 管理连接器 → 自定义连接器 → 我的连接器」；部分版本最后一项显示为「我的 MCP」。
- 找到 asklear，第一次出现时点击「信任」，并确认启用开关已经打开。
- 启用 asklear 后新建任务；启用前已经打开的旧任务可能无法加载新工具。
配置示例
{
"mcpServers": {
"asklear": {
"type": "streamable-http",
"url": "<YOUR_API_BASE_URL>/mcp",
"headers": {
"Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
}
}
}
}
QoderWork
官方文档QoderWork 在 Extensions → Connectors 中管理自定义 MCP，并可直接配置 Streamable HTTP 请求头。
配置步骤
- 打开 Extensions → Connectors，再选择 + Add → Fill in Config Manually。
- 选择 Streamable HTTP，并填写下方字段。
- 添加并启用服务器；新建对话，让刚启用的工具生效。
需要你操作
- 打开「Extensions → Connectors → Installed → Custom」，启用 asklear 服务器。
- 展开 asklear 并确认能看到工具，然后新建对话；已有对话不会加载刚启用的连接器。
配置示例
Server Name: asklear
Server URL: <YOUR_API_BASE_URL>/mcp
Header: Authorization: Bearer <YOUR_ASKLEAR_API_KEY>
Trae Work
官方文档Trae Work 可在云端 MCP 设置中添加远程 MCP 服务，并支持通过 JSON 导入完整配置。
配置步骤
- 在 Trae Work 中打开「设置 → MCP」，切换到「云端」，然后点击「创建」。
- 选择 JSON/手动配置，粘贴下方 JSON，然后点击「确认」。
- 使用 Builder with MCP，或把 asklear 添加到需要调用它的自定义智能体。
需要你操作
- 确认 asklear 在 MCP 列表中处于启用状态。
- 发送验证指令前，选择 Builder with MCP，或为准备使用它的自定义智能体启用 asklear。
配置示例
{
"mcpServers": {
"asklear": {
"url": "<YOUR_API_BASE_URL>/mcp",
"headers": {
"Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
}
}
}
}