关于 Marsell
Marsell 的托管 MCP 服务将 AI 客户端连接到 Marsell 项目,适用于个体创业者、中小企业和团队。根据授权权限,AI 可查看项目信息,并执行受支持的内容、营销和销售操作。
主要功能
- 01读取项目、品牌和市场信息
- 02查看分析数据与待处理决策
- 03按权限修改项目并执行操作
- 04处理内容、画布和视频
- 05先获取 Token 报价再生成图片
适用场景
- 01询问 Marsell 项目中哪些事项需要关注
- 02规划工作前查看品牌与市场背景
- 03开始前检查待办任务的截止事项
- 04委托获准的内容或营销操作
MCP 相关
托管的 Streamable HTTP MCP 服务位于 https://getmarsell.com/mcp,向 MCP 客户端提供 Marsell 项目工具。支持 OAuth 或 Agent 密钥认证,可用操作取决于权限。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://getmarsell.com/mcpclaude mcp add --transport http marsell-official-marsell https://getmarsell.com/mcp{"mcpServers":{"marsell-official-marsell":{"type":"http","url":"https://getmarsell.com/mcp"}}}在 Cursor 中打开{"servers":{"marsell-official-marsell":{"type":"http","url":"https://getmarsell.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"marsell-official-marsell":{"type":"http","url":"https://getmarsell.com/mcp"}}}{"mcpServers":{"marsell-official-marsell":{"serverUrl":"https://getmarsell.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Marsell MCP
Marsell 可为独立创始人和中小企业自动处理内容、营销和销售,也支持团队和组织。其托管的 Model Context Protocol(MCP)服务可让你已在使用的 AI 与 Marsell 项目协作。
这是 Marsell 官方公开仓库,提供连接说明和 MCP Registry 元数据。托管后端为私有服务,不会在此仓库中分发。
服务 URL: https://getmarsell.com/mcp
传输方式: Streamable HTTP
Registry 名称: io.github.Marsell-Official/marsell
连接
使用 OAuth 登录
在支持远程服务和 OAuth 的 MCP 客户端中,添加 https://getmarsell.com/mcp,选择 OAuth 身份验证,登录 Marsell,并在点击 Allow 前检查权限。请勿选择 No authentication。客户端套餐和管理员权限可能影响连接器的可用性;请参阅连接指南。
对于 Claude Code:
claude mcp add --transport http marsell https://getmarsell.com/mcp
然后运行 /mcp,选择 marsell,再选择 Authenticate。
使用 Agent 密钥连接
在 Marsell 中打开一个项目,前往 Agents → Your own AI,然后选择 Make a key。选择 Reads only;如果你希望 Agent 也能修改内容并消耗令牌,则选择 Can act。密钥显示时请复制;它只会显示一次。
对于 Codex,请在启动 Codex 的 shell 中设置环境变量:
export MARSELL_KEY='YOUR_MARSELL_AGENT_KEY'
codex mcp add marsell --url https://getmarsell.com/mcp --bearer-token-env-var MARSELL_KEY
在 PowerShell 中,使用 $env:MARSELL_KEY = 'YOUR_MARSELL_AGENT_KEY' 设置变量,然后运行相同的 codex mcp add 命令。
或者,在 ~/.codex/config.toml 中配置 Codex:
[mcp_servers.marsell]
url = "https://getmarsell.com/mcp"
bearer_token_env_var = "MARSELL_KEY"
其他客户端可以通过以下 HTTP 标头使用服务 URL:
Authorization: Bearer YOUR_MARSELL_AGENT_KEY
请通过客户端的安全凭据设置,将占位符替换为你自己的密钥。切勿将密钥提交到 Git 或粘贴到 issue 中。
你的 AI 可以做什么
- 查看项目、品牌信息、市场调研、人员、分析数据、令牌余额,以及等待你处理的决策。
- 获得授权后,回答决策、更新品牌信息、规划工作,并使用 Marsell 的内容、营销和销售工具。
- 先获取令牌报价再创建图片,并使用 Marsell 的聊天功能处理内容、画布和视频。
- 使用 AI 已有的上下文和文件来搭建业务。
- 处理需要使用你自己的 AI 登录信息或文件的作业,并将结果报告给 Marsell。
可用工具取决于你的权限。客户端可以通过 MCP tools/list 获取当前工具列表;完整文档介绍了这些工具及其审批要求。
试着这样提问:
这周 Marsell 上有哪些事情需要我处理?
读取我的品牌和市场信息,然后告诉我下一步该做什么。
检查我的 Marsell 作业,并在开始前告诉我有哪些截止事项。
作业本身不会创建后台计划。如果你希望定期检查,你的 AI 客户端必须支持计划任务;它可以通过 homework_schedule 将计划报告给 Marsell。
权限和账户访问
Reads only 允许 AI 查看信息。Can act 还允许执行受支持的更改和可能消耗令牌的操作。仍须遵守特定工具的审批要求,且 Marsell 会在每次调用时检查你当前的账户角色。团队和组织访问权限遵循你在 Marsell 中的权限设置。
你可以在 Agents → Your own AI → Connected apps and keys 下断开 OAuth 应用或撤销密钥。托管服务须符合账户、套餐和令牌要求。
故障排查
- 401 Unauthorized: 使用 OAuth 进行身份验证,或提供有效的 Agent 密钥。该端点需要身份验证。
- 在浏览器中打开 URL 失败: 这是 Streamable HTTP MCP 端点,而不是网页。请使用 MCP 客户端。
- 缺少某个工具或操作被拒绝: 检查连接的权限范围、你的当前角色以及该工具的要求。
- 密钥停止工作: 检查密钥是否已撤销,以及客户端是否仍能读取其环境变量。
可通过受保护资源元数据和授权服务器元数据进行 OAuth 发现。
仓库和注册表维护
server.json 描述了面向 MCP 官方注册表托管的服务。它不会安装或公开 Marsell 的后端。
连接说明和注册表元数据包含在 Marsell 的 MCP 过时检查中。托管接口发生变化时,维护者会根据实现审查此 README 和清单。注册表元数据变更需要使用官方 mcp-publisher 验证,并在发布前创建新版本;仅更改此 GitHub 仓库不会更新注册表。
如需报告连接或文档问题,请通过此仓库提交 issue,并且不要附上凭据或私有项目数据。
许可证
此仓库中的文档和元数据采用 MIT 许可证。该许可证不涵盖 Marsell 托管服务、其私有后端,也不涵盖 Marsell 的商标和品牌资产。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。