关于 Odiseo
Odiseo CLI 将受支持的编码客户端连接到已授权组织的 SEO MCP 服务，支持 OAuth 或 API 密钥登录、客户端配置和连接检查，涵盖研究、内容审核与发布流程。
主要功能
- 01OAuth 设备流与 API 密钥登录
- 02为四种客户端安装 MCP 配置
- 03检查凭据与端点连接
- 04研究网站并制定内容计划
- 05创建和审核文章
适用场景
- 01将 Cursor 连接到组织的 SEO 服务
- 02在工作前检查 MCP 凭据
- 03研究网站并准备文章简报
- 04获批后审核内容并管理发布
MCP 相关
它可将 Odiseo 的 Streamable HTTP MCP 服务配置到 Codex、Claude Code、Cursor 或 OpenClaw，也支持客户端直接连接服务端点。该服务提供 SEO 研究、内容创建与审核及发布工作流工具。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://www.odiseo.help/api/mcpclaude mcp add --transport http help-odiseo https://www.odiseo.help/api/mcp{"mcpServers":{"help-odiseo":{"type":"http","url":"https://www.odiseo.help/api/mcp"}}}在 Cursor 中打开{"servers":{"help-odiseo":{"type":"http","url":"https://www.odiseo.help/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"help-odiseo":{"type":"http","url":"https://www.odiseo.help/api/mcp"}}}{"mcpServers":{"help-odiseo":{"serverUrl":"https://www.odiseo.help/api/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Odiseo CLI
通过一条命令将 Codex、Claude Code、Cursor 或 OpenClaw 连接到 Odiseo SEO MCP。
Odiseo 为 Agent 提供工具，用于研究网站、制定简报和内容计划、创建和审核文章，以及在你授权的组织内执行发布工作流。
要求
- Node.js 20 或更高版本
- 拥有 MCP 访问权限的 Odiseo 组织账号
- 一个受支持的客户端：Codex、Claude Code、Cursor 或 OpenClaw
快速入门
使用 OAuth 设备流程在浏览器中进行身份验证：
npx odiseo-cli login
然后在客户端中安装 Odiseo：
npx odiseo-cli mcp install cursor
将 cursor 替换为 codex、claude 或 openclaw。最后，验证凭据和 MCP 端点：
npx odiseo-cli mcp doctor
登录命令会显示一个短代码，并打开 Odiseo 授权页面。生成的会话会保存到 ~/.config/odiseo/config.json，且仅所有者可访问。安装命令会将该持有者凭据放入所选客户端的用户级 MCP 配置中。
命令
odiseo login
启动 OAuth 设备授权流程：
odiseo login
odiseo login --no-open
用于本地开发：
odiseo login --base-url http://localhost:3000 --no-open
高级用户也可以改用现有的 Odiseo MCP API 密钥进行身份验证：
odiseo login --key seoap_your_key
API 密钥可以限定到特定网站，并设置更精简的权限。浏览器 OAuth 和设备授权代表完整的组织成员权限。
odiseo mcp install
安装经过身份验证的 Streamable HTTP 服务定义：
odiseo mcp install codex
odiseo mcp install claude
odiseo mcp install cursor
odiseo mcp install openclaw
默认端点为 https://odiseo.help/api/mcp。在本地或可自托管环境中，可覆盖此端点：
odiseo mcp install cursor --endpoint http://localhost:3000/api/mcp
客户端行为：
| 客户端 | 安装方式 |
|---|---|
| Cursor | 将 odiseo 合并到 ~/.cursor/mcp.json |
| Codex | 仅替换 ~/.codex/config.toml 中的 [mcp_servers.odiseo] |
| Claude Code | 在用户级别运行 claude mcp add |
| OpenClaw | 通过 Streamable HTTP 传输运行 openclaw mcp set |
Cursor 和 Codex 配置文件会以原子方式写入，并设置为 0600 权限。Claude Code 和 OpenClaw 会自行管理并保护各自的配置存储。
odiseo mcp doctor
使用已存储的凭据发送真实的 MCP initialize 请求：
odiseo mcp doctor
odiseo doctor
它会报告 MCP 服务名称、协议版本和延迟，也会针对凭据过期、缺少订阅访问权限和 HTTP 身份验证失败提供具体指导。
odiseo logout
删除此 CLI 存储的凭据。客户端配置会保留，因此你可以重新运行 odiseo login 和 odiseo mcp install <client>，而不会丢失无关设置。
不使用 CLI 进行连接
每个受支持的客户端也都可以使用 Odiseo 原生的 MCP OAuth 发现功能。只需添加此 URL：
https://odiseo.help/api/mcp
例如：
codex mcp add odiseo --url https://odiseo.help/api/mcp
codex mcp login odiseo
claude mcp add --transport http odiseo https://odiseo.help/api/mcp
openclaw mcp set odiseo \
'{"url":"https://odiseo.help/api/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login odiseo
Cursor 用户可以使用 odiseo.help/mcp 上的 Add to Cursor 按钮。
安全
- CLI 绝不会打印已保存的持有者令牌。
- 文件以原子方式写入；在支持的平台上，仅所有者可访问。
- 子进程会直接启动，绝不通过 shell 启动。
- OAuth/设备凭据会授予对已授权组织的访问权限。
- 发布和审批工具仍属于高影响操作：Agent 只能在用户明确指示后调用。
- 如果更适合使用有效期较长且范围更窄的凭据，请使用限定到特定网站的
seoap_API 密钥。
如果凭据泄露，请在 Odiseo 中撤销该凭据，然后再次运行 odiseo login。
开发
npm install
npm run typecheck
npm test
构建输出会生成在 dist/ 中。此软件包没有运行时依赖项。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。