内容
# SquaredUp MCP
官方 [SquaredUp](https://squaredup.com) 的 AI 代理市场。安装一个区域插件后，您选择的代理可以查询和管理您的 SquaredUp 组织 - **仪表盘**、**知识图谱**、**数据流**、**关键绩效指标（KPI）**、**工作区** 和 **集成** - 通过 SquaredUp 的托管 MCP 服务器，并使用一组捆绑的技能，教导任何代理如何有效地使用它。
## 您将获得
- **一个区域的 MCP 服务器** - 浏览器 OAuth，无需配置，无需管理 API 密钥。
- **十四项技能**，引导您的代理完成实际的 SquaredUp 工作流程：探索租户、读取仪表盘、查询数据流和实体图、处理 KPI、克隆工作区、管理集成、警报和通知渠道、权限和共享、计划报告和管理用户。
## 为 Claude 安装
### 1. 添加市场
在任何 Claude Code 会话中运行以下命令：
```
/plugin marketplace add squaredup/mcp
```
### 2. 安装您的区域
选择与您的 SquaredUp 组织托管区域对应的插件：
```
/plugin install us@squaredup # 美国
```
```
/plugin install eu@squaredup # 欧盟
```
区域插件**自动拉取共享的 `skills@squaredup` 插件**作为依赖项 - 一个命令安装所有内容。它只安装**您区域的 MCP 服务器**；另一个区域永远不会被添加。
| 区域 | 插件 | 服务器 | 端点 |
| ------ | -------------- | -------------- | ---------------------------------- |
| 美国 | `us@squaredup` | `squaredup-us` | `https://mcp.squaredup.com/mcp` |
| 欧盟 | `eu@squaredup` | `squaredup-eu` | `https://eu.mcp.squaredup.com/mcp` |
不确定您所在的区域？请检查您登录 SquaredUp 时使用的 URL - 欧盟租户使用 `eu.` 主机。
### 3. 身份验证
运行 `/mcp`，选择您区域的服务器，然后登录。身份验证基于浏览器，使用您现有的 SquaredUp 帐户 - 无需复制令牌。第一次工具调用将提示您如果尚未登录。
### 跨区域组织
安装**两个**区域插件：
```
/plugin install us@squaredup
/plugin install eu@squaredup
```
两个服务器都将存在（共享技能只安装一次）。当任务不明确时，Claude 将在运行任何工具之前询问您要哪个区域，然后坚持使用该区域的服务器完成任务的其余部分。
## 手动 MCP 配置（无插件）
如果您想直接连接 MCP 服务器，请在 Claude Code MCP 配置中为您的区域添加以下条目。
**美国：**
```json
{
"mcpServers": {
"squaredup": {
"type": "http",
"url": "https://mcp.squaredup.com/mcp"
}
}
}
```
**欧盟：**
```json
{
"mcpServers": {
"squaredup": {
"type": "http",
"url": "https://eu.mcp.squaredup.com/mcp"
}
}
}
```
OAuth 流与之前相同 - 第一次工具调用会提示您登录。请注意，如果没有插件，您将不会获得捆绑的技能。
## 其他代理（Cursor、Codex 等）
这些技能发布到 [Agent Skills](https://agentskills.io) 开放标准，可以使用 [`skills` CLI](https://skills.sh) 安装到任何兼容的代理中：
```bash
npx skills add squaredup/mcp # 安装所有技能
npx skills add squaredup/mcp --list # 列出可用技能
npx skills add squaredup/mcp --skill explore-org # 安装一项技能
```
CLI 通过 `.claude-plugin/marketplace.json` 中的 `skills` 插件条目的 `skills` 字段发现这些技能。这些技能依赖于连接的 SquaredUp MCP 服务器（请如上配置一个）。
## 更新
```
/plugin marketplace update squaredup
```
区域插件版本固定，因此您会在我们发布新版本时收到更新。
## 仓库布局
```
.claude-plugin/marketplace.json # 市场化 "squaredup" -> us, eu, skills
plugins/
skills/ skills/<name>/SKILL.md # 14 个共享技能，只需定义一次（无 MCP）
us/ .mcp.json # squaredup-us -> mcp.squaredup.com （依赖于技能）
eu/ .mcp.json # squaredup-eu -> eu.mcp.squaredup.com （依赖于技能）
```
`us` 和 `eu` 声明 `"dependencies": ["skills"]`，因此技能只存在于一个位置，并被共享而不是重复。
