Phorest MCP Server and API by Cotlet

Name: Phorest MCP Server and API by Cotlet
Author: cotlet.dev

远程服务

cotlet.dev商业与营销02 天前更新

代码仓库访问官网

关于 Phorest MCP Server and API by Cotlet

Cotlet.dev 的 Phorest MCP 服务让 AI Agent 在已登录的 Phorest 账户中处理预约和客户记录，适用于沙龙与水疗团队。它提供托管连接，也可通过本地 stdio 服务转发调用。

主要功能

01预约与改期
02查看日程和空档
03查询客户历史记录
04为客户卡片添加备注
05支持托管和本地 stdio

适用场景

01为客户预约指定造型师
02查找造型师日程空档
03筛出八周未到店的客户
04在客户卡片记录过敏信息

MCP 相关

通过 Cotlet.dev 托管端点向 MCP 客户端提供 Phorest 工具。也可使用本地 stdio 服务，将工具调用转发至托管服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://cotlet.dev/mcp/v1/phorest/connect

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dev-cotlet-phorest https://cotlet.dev/mcp/v1/phorest/connect

Cursor.cursor/mcp.json{"mcpServers":{"dev-cotlet-phorest":{"type":"http","url":"https://cotlet.dev/mcp/v1/phorest/connect"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dev-cotlet-phorest":{"type":"http","url":"https://cotlet.dev/mcp/v1/phorest/connect"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dev-cotlet-phorest":{"type":"http","url":"https://cotlet.dev/mcp/v1/phorest/connect"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dev-cotlet-phorest":{"serverUrl":"https://cotlet.dev/mcp/v1/phorest/connect"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://cotlet.dev/mcp/v1/phorest/connect

Streamable HTTPhttps://cotlet.dev/mcp/v1/phorest需要授权

工具

详细介绍

如何将 Phorest 连接到 Claude Code、ChatGPT 和任意 AI Agent

Claude、ChatGPT 和其他 AI Agent 确实可以在你的 Phorest 账户中工作。 Phorest 提供用于自定义集成的 API，但 ChatGPT 中没有官方 Phorest 应用，Claude 中也没有官方连接器。Cotlet.dev 会将你已登录的 Phorest 账户连接到任意 AI Agent，这样你只需用日常语言提问，AI 就能帮你预约、重新预约和查询客户。

你可以这样提问

为 Sarah Murphy 预约一项剪染服务，安排在周四上午 11 点，由 Aoife 服务。

显示明天每位造型师的预约情况，以及所有超过 45 分钟的空档。

哪些客户已经 8 周没来了？列出他们上次接受的服务和服务造型师。

将 Ciara 周六的所有预约转给 Niamh，并保留原来的时间。

在 Tom Byrne 的客户档案中添加备注：对氨过敏，请使用温和系列。

2 分钟内完成连接

在 https://cotlet.dev/app 获取 API 密钥，并将其导出为 COTLET_API_KEY。

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

依次选择“设置”→“应用”→“添加连接器 URL”，输入 https://cotlet.dev/mcp/v1，然后使用 Cotlet.dev 登录。无需 API 密钥。

Cursor

将此仓库中的 .cursor/mcp.json 复制到你的项目中：

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

在本地运行（stdio）

此仓库是一个真正的 MCP 服务。它通过 stdio 使用 MCP，在没有任何密钥的情况下列出 Phorest 工具，并将每次工具调用转发到托管的 Cotlet.dev 服务。上方的托管 URL 仍是推荐方式。如果你的客户端只能启动本地服务，请使用此方式。

{"mcpServers":{"phorest":{"command":"uvx","args":["phorest-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

也可以使用 Docker：

docker build -t phorest-mcp .
docker run -i --rm -e COTLET_API_KEY phorest-mcp

工具：phorest_guide、phorest_status、phorest_open、phorest_read、phorest_click、phorest_type、phorest_close。如果没有 COTLET_API_KEY，工具调用会回复：“请设置 COTLET_API_KEY。在 https://cotlet.dev/app 获取密钥”。

命令行

需要 Python 3.10+，无需安装其他内容。从 PyPI 安装：

pip install phorest-mcp        # or run it once: uvx phorest-mcp connect
phorest-mcp connect

或直接从此仓库安装：

export COTLET_API_KEY="your-key"
python3 phorest_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 phorest_agent.py status    # is Phorest ready in your Cotlet.dev account
python3 phorest_agent.py guide     # Phorest screens and sign-in link
python3 phorest_agent.py read      # open Phorest, read the page, close the browser
python3 phorest_agent.py tools     # list Cotlet.dev tools
python3 phorest_agent.py serve     # start the stdio MCP server (same as no argument)

Phorest 用户常见问题

Phorest 有 API 吗？

Phorest 有 API，但只能通过 Phorest Support 获取凭据；申请时需要提供账户号码，且设置需要由你自己的开发团队完成。Cotlet.dev 则直接在你已登录的 Phorest 账户中工作，因此 AI Agent 无需编写代码，就能预约并管理客户。

如何将 Phorest 连接到 ChatGPT？

在 ChatGPT 中将 Cotlet.dev 添加为应用（“设置”→“应用”，连接器 URL 为 https://cotlet.dev/mcp/v1），在 Cotlet.dev Cloud Browser 中登录 Phorest 一次，然后用日常语言向 ChatGPT 提问。无需编写代码，也无需 Phorest API 密钥。

有没有办法将 Claude 与 Phorest 配合使用？

有。在 Claude Code 中运行上方的一行 claude mcp add 命令；在 Claude 应用中，将 https://cotlet.dev/mcp/v1 添加为自定义连接器。之后，Claude 就能在你自己的 Phorest 账户中工作。

Phorest 有 MCP 服务吗？

Phorest 没有官方 MCP 服务，也没有 ChatGPT 或 Claude 官方应用（截至 2026 年 11 月已核实）。Cotlet.dev 是一个托管的 Phorest MCP 服务，可在你自己的账户中使用，并兼容 Claude、ChatGPT、Cursor、Codex、n8n、Make 和 Zapier。