让AI助手读取你的Gorelo公益广告——你的工单积压、客户、联系人和 受管理设备——通过代表你与Gorelo API对话。

它运行在你自己的机器上，并对MCP进行语音处理 STDIN/STDOUT。没有托管，也没有暴露在互联网上，你的API密钥也永远不会 离开你的电脑。

二十三个工具，其中十九个是只读的。 普通红宝石——没有宝石，没有捆绑器，没有构建步骤。

⚠️ 更正 — 2026年9月11日

本 README 的早期版本作为既定事实指出，Gorelo 没有 可读的时间输入API，而且每用户小时数是不可能的。当时确实如此 是写好的。现在是假的。 Gorelo的2026年9月4日发布 GET /v1/time-entries — 每个记录条目一行，租户范围，每行载用户 记录了它——还有/v1/contracts、/v1/billing-roles和/v1/work-types。

gorelo_time_report 已在此基础上重建。它不再将工单的营业时间归属于 主受让人，不再警告每人总计为“指示性”，也不再 每张工单需要一次请求。**如果你基于旧限制或重复构建了什么

Gorelo MCP server

Lets an AI assistant read your Gorelo PSA — your ticket backlog, clients, contacts and managed devices — by talking to the Gorelo API on your behalf.

It runs on your own machine and speaks MCP over stdin/stdout. Nothing is hosted, nothing is exposed to the internet, and your API key never leaves your computer.

Twenty-three tools, nineteen of them read-only. Plain Ruby — no gems, no Bundler, no build step.

⚠️ Correction — 11 September 2026

Earlier versions of this README stated, as established fact, that Gorelo has no readable time-entry API and that per-user hours were impossible. That was true when it was written. It is false now. Gorelo’s 4 September 2026 release shipped GET /v1/time-entries — one row per logged entry, tenant-wide, each carrying the user who logged it — along with /v1/contracts, /v1/billing-roles and /v1/work-types.

gorelo_time_report has been rebuilt on it. It no longer attributes a ticket’s hours to the lead assignee, no longer warns that per-person totals are “indicative”, and no longer costs one request per ticket. If you built anything on the old limitation, or repeated it to anyone, it needs revisiting. Details: what changed on 4 September 2026.

One more thing from that release: until 3 October 2026 a contract was what Gorelo’s web UI called a “Contract Group”, and a ServiceLine was what the UI called a “Contract”. That was true then; the UI now uses the API’s words. See contract naming.

---

Install

Pick whichever you already have. Both are equally supported.

# Ruby (skip if `ruby -v` already works)
sudo apt update && sudo apt install -y ruby      # Debian/Ubuntu
# brew install ruby                              # macOS

git clone  ~/gorelo-mcp     # or just copy the folder there
cd ~/gorelo-mcp
cp .env.example .env && nano .env      # fill in your API key

Check it starts and answers:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}' \
  | ruby gorelo-mcp-server.rb

You want a JSON line containing "serverInfo", plus two [gorelo-mcp] lines on stderr.

Then add it to your MCP client’s config. For Claude Desktop that is %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS:

{
  "mcpServers": {
    "gorelo": {
      "command": "wsl.exe",
      "args": ["-d", "Ubuntu", "-e", "/usr/bin/ruby",
               "/home/YOURNAME/gorelo-mcp/gorelo-mcp-server.rb"]
    }
  }
}

On Linux or macOS, drop the wsl.exe wrapper:

{
  "mcpServers": {
    "gorelo": {
      "command": "/usr/bin/ruby",