MCP

Favonis 提供一个远程 MCP 服务，Claude Code、Cursor 这类支持 MCP 的 AI 工具连接后，可以把需要多步操作、要用电脑或要交付文件的工作交给 Favonis，再读取结果和文件的文字内容。服务地址是 https://api.favonis.com/mcp，使用 Streamable HTTP 传输、不保持会话，用请求头 Authorization: Bearer fvk_... 认证，密钥和 REST 共用。

连接 Claude Code

claude mcp add --transport http favonis https://api.favonis.com/mcp \
  --header "Authorization: Bearer fvk_..."

添加后在 Claude Code 中输入 /mcp，可以看到 favonis 和它提供的工具。

连接 Cursor

在 ~/.cursor/mcp.json（只对某个项目生效时用项目里的 .cursor/mcp.json）中加入：

{
	"mcpServers": {
		"favonis": {
			"url": "https://api.favonis.com/mcp",
			"headers": {
				"Authorization": "Bearer fvk_..."
			}
		}
	}
}

其他客户端

支持远程 MCP 服务（Streamable HTTP）并能自定义请求头的客户端都可以连接：地址填 https://api.favonis.com/mcp，请求头填 Authorization: Bearer fvk_...。

目前不支持 OAuth 授权，因此暂时无法在 Claude.ai、ChatGPT 这类只能通过账号授权添加连接器的网页应用中连接。

提供的工具

工具	作用
create_task	新建任务，立即返回；执行中不会中途提问
get_task	查看任务的状态和最新一轮的结果，用 wait 最多等待 25 秒
list_tasks	按创建时间倒序列出任务
send_task_message	给任务发消息：补充说明、回答问题、继续或开始新的一轮
cancel_task	取消正在进行的这一轮，不等执行收尾，返回时可能仍是 running
read_file	读取文件的文字内容
list_projects	列出项目
list_project_files	列出项目里一个文件夹的内容
list_models	列出可用的模型和档位

工具的参数和返回与同名的 REST 接口相同，见 API 参考。删除任务、上传附件、获取下载地址和查看账号目前只能通过 REST 完成。

使用只读密钥时，只能调用 get_task、list_tasks、read_file、list_projects、list_project_files 和 list_models。工具调用失败时，返回内容是和 REST 相同的错误码，例如 error.chat_concurrency_exceeded；参数错误时另附一段说明，内容同 REST 的 fields.detail。

使用建议

• AI 工具会自行决定什么时候调用 Favonis，每个任务都会消耗积分。建议为它单独创建一个密钥并设置每月积分上限，见认证与密钥。
• 任务通常要运行几分钟甚至更久。工具会用 get_task 的 wait 反复等待，期间可以在 Favonis 中打开任务的 url 查看进度。
• MCP 的工具调用不支持幂等键。create_task 超时后，先用 list_tasks 确认任务是否已建好；send_task_message 超时后，先用 get_task 查看任务的状态，再决定是否重试。