# 好用画布连接指南 · MCP

用户说“帮我连接这个网站”时，完成下面的配置、启动授权和验证。沿用用户现有助手、模型和推理服务。
MCP 地址：https://haoyongcanvas.com/mcp
机器可读配置：https://haoyongcanvas.com/api/agent-connect/manifest
账户连接管理：https://haoyongcanvas.com/?page=agents

## 完成连接

1. 检查当前客户端及已有 MCP 配置。同名同地址且字段正确时复用；同地址但传输字段错误时只修正本站条目，不覆盖其他服务器、模型、账号或权限设置。先辨别已有连接的 OAuth / Token 模式，不把失效的固定 Authorization 头与 OAuth 混用。用户已要求连接时，执行有能力完成的配置步骤，不反复把配置工作交回用户。
2. 先识别你正在运行的客户端与版本，再读取下列对应指南。QCoder、Qoder 和 Qwen Code 是不同产品，不能互换配置。DeepSeek 是模型名称；使用它的宿主客户端负责 MCP 配置和授权。不要仅按模型名称选择客户端。
3. 让客户端真正连接 MCP。首次匿名请求返回 401 和 WWW-Authenticate 是启动 OAuth 的正常挑战，不是接通证明。由客户端发现元数据、动态注册、生成 PKCE，并打开本站授权页。助手可启动流程；用户亲自登录并确认画布及权限。不要把打开正常 OAuth 流程说成禁止“代理账号认证”。
4. 用户确认后，回到同一客户端完成回调、交换凭据和工具发现。真实执行 account_get 与 canvases_list，成功才报告连接完成。空画布列表也是有效结果。网站“已授权”、客户端“已配置”、无成功调用记录，均不能替代此验证。不要为验证连接生成图片、视频、音频或付费文字。
5. 若当前对话尚未重新加载工具，使用宿主确实提供的刷新/重连动作；只有宿主无法完成时才说明必要的最少点击。不得凭空声称有工具或编造界面入口。

## 当前客户端配置

```
{
  "mcpServers": {
    "haoyongcanvas": {
      "url": "https://haoyongcanvas.com/mcp"
    }
  }
}
```

## 各客户端独立指南

- Codex: https://haoyongcanvas.com/api/agent-connect/guide?client=codex
- Claude Code: https://haoyongcanvas.com/api/agent-connect/guide?client=claude
- Cursor: https://haoyongcanvas.com/api/agent-connect/guide?client=cursor
- WorkBuddy: https://haoyongcanvas.com/api/agent-connect/guide?client=workbuddy
- Qoder: https://haoyongcanvas.com/api/agent-connect/guide?client=qoder
- Qwen Code: https://haoyongcanvas.com/api/agent-connect/guide?client=qwen
- QCoder: https://haoyongcanvas.com/api/agent-connect/guide?client=qcoder
- ChatGPT: https://haoyongcanvas.com/api/agent-connect/guide?client=chatgpt
- OpenClaw: https://haoyongcanvas.com/api/agent-connect/guide?client=openclaw
- Gemini CLI: https://haoyongcanvas.com/api/agent-connect/guide?client=gemini
- MCP: https://haoyongcanvas.com/api/agent-connect/guide?client=generic

## 凭据、授权与费用

OAuth 是首选。手动 MCP Token 是单独的备用方式，不能与 OAuth 步骤混用；MCP Token 不能用作推理 key。不要把真实密钥放进聊天、命令参数、历史或普通配置。客户端自己的安全凭据存储正常使用，不读取或挪用助手厂商的登录凭据。
画布工具沿用助手的推理服务。本站生成仍按用户已授权的计划、预算、报价和积分执行。连接不会自动启用平台推理，不改变宿主自身的安全确认规则。
可选模型 API：https://haoyongcanvas.com/api/agent-inference/info。如用户另行要求切换推理服务，再读对应客户端指南；不要从“连接画布”推导出模型切换或付费回退授权。

## 排错与恢复

- 401：无凭据时发起客户端 OAuth；已有凭据时按原连接刷新或重新授权。不要将 401 写成连接成功。
- 403：核对资源、域名、画布与权限。正式 MCP/OAuth 使用 https://haoyongcanvas.com，不把品牌别名当成第二个授权发行方。
- 网站授权页报错：重新读取当前公开 manifest；检查是否带有过期 agent_request。授权请求由客户端新建，直接打开账户管理页不会触发 OAuth。记录失败步骤与 HTTP 状态，不索取客户密码、Token、Cookie 或完整带授权码的 URL。
- 连接器不存在/工具列表为空：核实真实配置文件、作用域、启用和刷新状态；不要让用户寻找未经核实的按钮。
- 任务断线：先 account_get / canvases_list / tasks_list / task_get 查询已有记录。保留 requestId/quoteId/taskId，同一请求重试不能重新付费。