SquaredUp (US)

SquaredUp MCP

面向 AI Agent 的官方 SquaredUp 市场。安装区域插件后，你选择的 Agent 就可以通过 SquaredUp 托管的 MCP 服务查询和管理你的 SquaredUp 组织，包括仪表板、知识图谱、数据流、KPI、工作区和集成。

你将获得

• 每个区域对应一个 MCP 服务——浏览器 OAuth，无需配置，也无需管理 API 密钥。
• 内置技能——服务的 get_skill 工具会引导你的 Agent 完成实际的 SquaredUp 工作流：浏览租户、读取仪表板、查询数据流和实体图谱、处理 KPI、克隆工作区、管理集成、警报和通知渠道、权限和共享、定期报告，以及管理用户。无需额外安装。

选择你的 Agent

Agent	安装方式
Claude Code	插件市场
Claude desktop and claude.ai	插件市场或自定义连接器
Cursor	一键按钮
VS Code	一键按钮或 code --add-mcp
Codex	插件市场或 codex mcp add
GitHub Copilot CLI	插件市场
Antigravity CLI	此仓库中的插件
Gemini CLI	gemini mcp add
ChatGPT	自定义 MCP 服务
Copilot Studio	Agent 中的 MCP 工具
Other MCP clients	服务 URL

为 Claude Code 安装

1. 添加市场

在任意 Claude Code 会话中运行一次：

/plugin marketplace add squaredup/mcp

2. 安装你的区域插件

选择与你的 SquaredUp 组织所在区域对应的插件：

/plugin install us@squaredup     # US

/plugin install eu@squaredup     # EU

区域插件只会安装你所在区域的 MCP 服务；不会添加另一个区域的服务。

区域	插件	服务	端点
US	us@squaredup	squaredup-us	https://mcp.squaredup.com/mcp
EU	eu@squaredup	squaredup-eu	https://eu.mcp.squaredup.com/mcp

不确定自己所在的区域？查看你用于登录 SquaredUp 的 URL——EU 租户使用 eu. 主机名。

3. 身份验证

运行 /mcp，选择你所在区域的服务并登录。身份验证通过浏览器进行，使用你现有的 SquaredUp 账户，无需复制令牌。如果你尚未登录，首次调用工具时会提示你登录。

跨越两个区域的组织

安装两个区域插件：

/plugin install us@squaredup
/plugin install eu@squaredup

两个服务都会显示。当任务存在歧义时，Claude 会在运行任何工具前询问你指的是哪个区域，之后在该任务的剩余过程中只使用该区域的服务。

为 Claude desktop 和 claude.ai 安装

Claude 桌面应用和 claude.ai 的步骤相同，无需编辑配置文件。无论使用哪种方式，服务都会保存到你的 Claude 账户中，因此你可以在聊天和 Cowork 中使用。

作为插件

1. 打开 Customize > Plugins，选择 Add marketplace，然后输入 squaredup/mcp。
2. 找到适用于你所在区域（us 或 eu）的插件，然后选择 Add。
3. 打开插件的 Connectors 选项卡，添加其服务，然后选择 Connect，使用你的 SquaredUp 账户登录。

下次使用同一账户登录并启动会话时，该插件也会连接到 Claude Code，因此无需在那里重复安装。要获取新版本，请在 marketplace 中选择 Check for updates，或开启 Sync automatically。

作为自定义连接器

1. 打开 Customize > Connectors，然后选择 Add custom connector。
2. 输入你所在区域的服务 URL（美国为 https://mcp.squaredup.com/mcp，欧盟为 https://eu.mcp.squaredup.com/mcp），然后选择 Add。
3. 选择 Connect 登录。

Free 套餐允许添加一个自定义连接器。

Team 和 Enterprise 套餐

成员无法自行添加自定义连接器，因此需要由 Owner 先为组织添加服务。在 Organization settings > Connectors 中选择 Add，然后选择 Custom；如果系统询问，请选择 Web，再输入你所在区域的服务 URL。之后，成员可在 Customize > Connectors 下找到它（带有 Custom 标签），并选择 Connect。插件也是如此：如果其 Connectors 选项卡将服务显示为 Not added，请联系 Owner 添加。

手动配置 MCP（不使用插件）

如果你更愿意直接配置 MCP 服务，请将你所在区域对应的条目添加到 Claude Code MCP 配置中。

美国：

{
    "mcpServers": {
        "squaredup": {
            "type": "http",
            "url": "https://mcp.squaredup.com/mcp"
        }
    }
}

欧盟：

{
    "mcpServers": {
        "squaredup": {
            "type": "http",
            "url": "https://eu.mcp.squaredup.com/mcp"
        }
    }
}

OAuth 流程完全相同——首次调用工具时会提示你登录。技能由服务本身提供，因此无论是否使用插件，你都能获得这些技能。

为其他 Agent 安装

以下每种方式都只会添加你所在区域的 MCP 服务。技能由服务提供，因此无需安装其他内容。Agent 首次连接时，请在浏览器中使用你的 SquaredUp 账户登录。

一键安装

Agent	US	EU
Cursor
VS Code

VS Code 也可以通过命令行添加服务：

code --add-mcp '{"name":"squaredup-us","type":"http","url":"https://mcp.squaredup.com/mcp"}'

VS Code 也可以安装此仓库的插件（这是一项实验性设置）。将市场添加到设置中，然后在扩展视图中搜索 @agentPlugins，并安装适用于你所在区域的插件：

"chat.plugins.marketplaces": ["squaredup/mcp"]

命令行

以下命令适用于 US 区域。对于 EU，请改用 eu@squaredup、squaredup-eu 和 https://eu.mcp.squaredup.com/mcp。

Codex

Codex 可以直接读取此仓库的市场：

codex plugin marketplace add squaredup/mcp
codex plugin add us@squaredup

Codex IDE 扩展不支持插件。请直接添加服务；CLI 和 IDE 扩展共用相同的配置：

codex mcp add squaredup-us --url https://mcp.squaredup.com/mcp

GitHub Copilot CLI

Copilot CLI 也可以读取此仓库的市场：

copilot plugin marketplace add squaredup/mcp
copilot plugin install us@squaredup

Antigravity CLI

Antigravity CLI 可直接从此仓库安装对应区域的插件：

agy plugin install https://github.com/squaredup/mcp/tree/main/plugins/us

插件名为 squaredup-us（EU 区域使用 squaredup-eu）。请按区域文件夹安装，而不是从仓库根目录安装：根目录 URL 会安装两个区域。

Gemini CLI

对于大多数账户，Gemini CLI 已被 Antigravity CLI 取代。如果你仍在使用它：

gemini mcp add --transport http squaredup-us https://mcp.squaredup.com/mcp

ChatGPT

在网页版 ChatGPT 中，前往 Plugins，选择 +，然后选择 Add custom MCP server。粘贴你所在区域的服务 URL（美国：https://mcp.squaredup.com/mcp；欧盟：https://eu.mcp.squaredup.com/mcp），并按提示登录。能否添加自定义服务取决于你的套餐和工作区设置。

Copilot Studio

要在 Copilot Studio 中构建的 Agent 中使用 SquaredUp，请将服务添加为 MCP 工具。你需要 Copilot Studio 许可证；试用版可以用于测试 Agent，但不能发布。

1. 打开你的 Agent，在 Build 选项卡中，选择 Tools 旁边的 +。
2. 在 Add a tool 中，选择 + Add > Model Context Protocol (MCP)。
3. 填写表单：
   • Server name： SquaredUp
   • Server description： Agent 会根据此描述决定何时调用 SquaredUp，例如：Query and manage SquaredUp dashboards, data streams, the knowledge graph, and KPIs.
   • Server URL： https://mcp.squaredup.com/mcp（美国）或 https://eu.mcp.squaredup.com/mcp（欧盟）
4. 在 Authentication 下，选择 OAuth 2.0，并将 Configuration type 保留为 Dynamic (with discovery)。无需填写客户端 ID 或密钥。选择 Add。
5. 在 Select a connection 中，打开 Connection 列表，选择 Create new connection，然后选择 Create。在弹出窗口中使用 SquaredUp 账户登录，并在询问时选择你的组织。如果没有弹出窗口，请允许 Copilot Studio 显示弹出窗口，然后再次选择 Create。
6. 选择 Add。

默认情况下，所有 SquaredUp 工具均已启用。Copilot Studio 在工具较少时效果最佳，因此请在 Tools 下选择 SquaredUp，关闭 Allow all，仅选择 Agent 需要的工具，然后选择 Done。在 Preview 选项卡中试用 Agent，例如让它列出你的 SquaredUp 工作区。

要在 Teams 和 Microsoft 365 Copilot 中使用该 Agent，请选择 Channels 旁边的 +，选择 Teams + Microsoft 365，然后选择 Add channel，再选择 Publish。该工具的 Authentication 默认设置为 End user account，因此每位用户在 Agent 首次调用工具时，都需要使用自己的 SquaredUp 账户登录。

如果无法添加服务，可能是 Power Platform 数据策略阻止了自定义连接器。请联系 Power Platform 管理员并请其允许使用自定义连接器。

其他 MCP 客户端

其他支持可流式传输 HTTP 和 OAuth 的 MCP 客户端可能也能使用，但我们只测试过上述客户端。请将其指向你所在区域的服务 URL：https://mcp.squaredup.com/mcp（美国）或 https://eu.mcp.squaredup.com/mcp（欧盟）。如果无法登录，请联系 SquaredUp 支持。

已使用 npx skills 安装 skills？

这些 skills 以前由此仓库发布，供 skills CLI 使用。现在它们由 SquaredUp MCP 服务提供，因此请删除旧副本，以免内容过时：

npx skills remove squaredup/mcp -y      # project install
npx skills remove squaredup/mcp -g -y   # global install

更新

/plugin marketplace update squaredup

区域插件固定到特定版本，因此我们发布新版本时，你就会收到更新。

仓库布局

.claude-plugin/marketplace.json   # marketplace "squaredup" -> us, eu
plugins/
  us/       .mcp.json              # squaredup-us -> mcp.squaredup.com
            mcp_config.json        # the same server for Antigravity
            plugin.json, mcp.json  # the same plugin in Agent Plugins format, for Copilot CLI and VS Code
            server.json            # MCP Registry entry (com.squaredup/us)
            .m365-plugin/          # Microsoft 365 Copilot app package, zipped on release
  eu/       .mcp.json              # squaredup-eu -> eu.mcp.squaredup.com
            mcp_config.json        # the same server for Antigravity
            plugin.json, mcp.json  # the same plugin in Agent Plugins format, for Copilot CLI and VS Code
            server.json            # MCP Registry entry (com.squaredup/eu)
            .m365-plugin/          # Microsoft 365 Copilot app package, zipped on release

每个区域文件夹都是一个 Claude Code 插件（.claude-plugin/plugin.json）和一个 Antigravity 插件（.antigravity-plugin/plugin.json）。Antigravity 可以在安装时转换 Claude Code 插件，但会丢弃 HTTP 服务的服务 URL，因此各区域文件夹都包含自己的 mcp_config.json。

每个清单都有自己的版本，但美国和欧盟必须使用相同版本，并且每个清单都必须指向其所在区域的服务 URL。每次推送到 main 时，Release 工作流都会检查这些设置。何时提升各清单的版本，请参阅 CHANGELOG.md。