Manager.io MCP

**插件（在配置界面中设置 URL、密钥和范围）：**本仓库通过 .cursor-plugin/plugin.json 和根目录中的 mcp.json 作为 Cursor 插件。

1. 将克隆目录符号链接或复制到 ~/.cursor/plugins/local/manager-mcp（Windows：%USERPROFILE%\.cursor\plugins\local\manager-mcp）。
2. 重新加载窗口。
3. 在 manager-mcp 上打开 Plugins → Configure。设置 Manager API URL 和 Manager API key。如需只读，请将 Write scopes / Delete scopes 留空；否则可粘贴 CSV，例如 quotes 或 quotes,orders。
4. 在 Customize / MCP 下确认已启用 manager MCP 服务。

Marketplace 列表需单独提交至 cursor.com/marketplace/publish。

**手动配置 mcp.json：**项目级 .cursor/mcp.json 或用户级 ~/.cursor/mcp.json。

从 PyPI 安装：

{
  "mcpServers": {
    "manager": {
      "type": "stdio",
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

本地可编辑安装（开发）：

{
  "mcpServers": {
    "manager": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/manager-mcp", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

可在 env 块中设置可选的范围写入权限：

"MANAGER_MCP_WRITE_SCOPES": "quotes",
"MANAGER_MCP_DELETE_SCOPES": "quotes"

保存后重启 Cursor。在 MCP 设置中确认 manager 已启用。

**桌面扩展（.mcpb）：**从 GitHub Releases 下载 mcpb.mcpb。请使用 v0.2.6 或更高版本。

1. 打开 Claude Desktop → Settings → Extensions。
2. 打开 Advanced settings → Install Extension…
3. 选择 mcpb.mcpb。检查权限，输入 Manager API URL 和 Manager API key，然后点击 Install。
4. 如需只读，请将 Write scopes 和 Delete scopes 留空。
5. 如果工具未显示，请重启 Claude Desktop。

从克隆目录自行构建扩展包：

npx @anthropic-ai/mcpb pack mcpb

在 Windows 上，双击通常不会有任何反应；将文件拖入聊天会把它作为附件添加到对话中，而不是安装扩展。请在 Settings 中使用 Install Extension…。

**手动配置 mcp.json：**编辑 Claude Desktop 配置，然后重启应用。

{
  "mcpServers": {
    "manager": {
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

本地克隆：

{
  "mcpServers": {
    "manager": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/manager-mcp", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

通过 CLI 添加：

claude mcp add manager --env MANAGER_API_URL=http://127.0.0.1:55667/api2 --env MANAGER_API_KEY=your-token -- uvx manager-mcp

或者编辑 ~/.claude.json / 项目 MCP 配置：

{
  "mcpServers": {
    "manager": {
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "manager": {
      "type": "stdio",
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

本地可编辑安装：

{
  "servers": {
    "manager": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/manager-mcp", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

重新加载窗口。打开 Copilot Chat，确认 manager 工具可用。

编辑 ~/.codeium/windsurf/mcp_config.json（macOS/Linux），或使用 Windsurf MCP 设置界面：

{
  "mcpServers": {
    "manager": {
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

保存后重启 Windsurf。

在 Zed 的 settings.json 中添加到 context_servers 下（也可通过 Agent Panel → settings 添加）：

{
  "context_servers": {
    "manager": {
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

编辑 Cline MCP 设置文件（通过 Cline MCP 界面找到 cline_mcp_settings.json）：

{
  "mcpServers": {
    "manager": {
      "command": "uvx",
      "args": ["manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

在 .continue/config.yaml 中：

mcpServers:
  - name: manager
    command: uvx
    args:
      - manager-mcp
    env:
      MANAGER_API_URL: http://127.0.0.1:55667/api2
      MANAGER_API_KEY: your-token

任何能够启动 stdio MCP 服务的宿主：

uvx manager-mcp

从克隆目录进行开发：uv run --directory /path/to/manager-mcp manager-mcp。

npx 只能运行 npm 包。这是一个 Python 包；请使用 uvx。