MCP server SquaredUp
Commit 12 de nov. de 2026Permite que agentes de IA consultem e gerenciem dashboards, knowledge graphs, data streams, KPIs e workspaces do SquaredUp.
Também conhecido como squaredup/mcp, mcp
- Stars
- 3
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 1.2.1
- Último commit
- 12 de nov. de 2026
- Licença
- MIT
O que é o MCP SquaredUp?
SquaredUp é um MCP server. Permite que agentes de IA consultem e gerenciem dashboards, knowledge graphs, data streams, KPIs e workspaces do SquaredUp.
Resumo gerado a partir do README do projeto
Sobre o MCP server de SquaredUp
O SquaredUp (EU) oferece um MCP server que permite que agentes de IA interajam diretamente com sua organização SquaredUp. Ele possibilita a consulta e o gerenciamento de dashboards, knowledge graphs, data streams, KPIs, workspaces e integrações. Este server foi projetado para usuários de diversos clientes de IA, incluindo Claude Desktop, Cursor, VS Code e ChatGPT, além de ferramentas de linha de comando como GitHub Copilot CLI e Antigravity CLI.
A configuração é simples porque utiliza OAuth via navegador para autenticação, o que significa que você não precisa gerenciar chaves de API ou tokens manualmente. Basta selecionar o plugin da região EU ou conectar-se ao endpoint específico da UE. O server inclui skills integradas por meio da ferramenta get_skill, que guia os agentes em fluxos de trabalho complexos, como explorar tenants, clonar workspaces, gerenciar permissões de usuários e lidar com canais de alerta ou notificação.
O que você pode fazer com ele
- 1Gerenciar workspaces organizacionaisUm agente de IA pode clonar workspaces existentes para replicar configurações.
- 2Analisar dados organizacionaisVocê pode instruir um agente a consultar data streams específicos ou o entity graph.
- 3Configurar alertas do sistemaUm agente pode ser usado para configurar ou gerenciar canais de notificação e configurações de alerta.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP SquaredUp
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP SquaredUp no Claude Code
$ claude mcp add --transport http mcp https://eu.mcp.squaredup.com/mcpInstalar o MCP SquaredUp no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://eu.mcp.squaredup.com/mcp"
}
}
}Instalar o MCP SquaredUp no VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://eu.mcp.squaredup.com/mcp"
}
}
}Instalar o MCP SquaredUp no VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://eu.mcp.squaredup.com/mcp"}'Instalar o MCP SquaredUp no Codex
$ codex mcp add mcp --url https://eu.mcp.squaredup.com/mcpInstalar o MCP SquaredUp no Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://eu.mcp.squaredup.com/mcp"
Instalar o MCP SquaredUp no Gemini CLI
$ gemini mcp add -s user --transport http mcp https://eu.mcp.squaredup.com/mcpInstalar o MCP SquaredUp no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://eu.mcp.squaredup.com/mcp",
"type": "http"
}
}
}Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelsquaredup/mcp is public and reachablegithub.com/squaredup/mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-12github.com/squaredup/mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPHTTPS endpoint answered 401 (sign-in required)Passou
README
Ver no GitHubSquaredUp MCP
The official SquaredUp marketplace for AI agents. Install a region plugin and your agent of choice can query and manage your SquaredUp organization - dashboards, the knowledge graph, data streams, KPIs, workspaces, and integrations - through SquaredUp's hosted MCP server.
What you get
- One MCP server for your region - browser OAuth, nothing to configure, no API keys to manage.
- Built-in skills - the server's
get_skilltool guides your agent through real SquaredUp workflows: exploring a tenant, reading dashboards, querying data streams and the entity graph, working with KPIs, cloning workspaces, managing integrations, alerting and notification channels, permissions and sharing, scheduled reports, and managing users. There is nothing extra to install.
Choose your agent
| Agent | How to install |
|---|---|
| Claude Code | Plugin marketplace |
| Claude desktop and claude.ai | Plugin marketplace or custom connector |
| Cursor | One-click button |
| VS Code | One-click button or code --add-mcp |
| Codex | Plugin marketplace or codex mcp add |
| GitHub Copilot CLI | Plugin marketplace |
| Antigravity CLI | Plugin from this repo |
| Gemini CLI | gemini mcp add |
| ChatGPT | Custom MCP server |
| Copilot Studio | MCP tool in your agent |
| Other MCP clients | Server URL |
Install for Claude Code
1. Add the marketplace
Run this once in any Claude Code session:
/plugin marketplace add squaredup/mcp
2. Install your region
Pick the plugin for the region your SquaredUp organization is hosted in:
/plugin install us@squaredup # US
/plugin install eu@squaredup # EU
The region plugin installs only your region's MCP server; the other region is never added.
| Region | Plugin | Server | Endpoint |
|---|---|---|---|
| US | us@squaredup |
squaredup-us |
https://mcp.squaredup.com/mcp |
| EU | eu@squaredup |
squaredup-eu |
https://eu.mcp.squaredup.com/mcp |
Not sure which region you're on? Check the URL you use to sign in to SquaredUp - EU tenants use an eu. host.
3. Authenticate
Run /mcp, select your region's server, and sign in. Authentication is browser-based using your existing SquaredUp account - there are no tokens to copy. The first tool call will prompt you if you haven't signed in yet.
Organizations that span both regions
Install both region plugins:
/plugin install us@squaredup
/plugin install eu@squaredup
Both servers will be present. When a task is ambiguous, Claude will ask which region you mean before running any tools, then stick to that region's server for the rest of the task.
Install for Claude desktop and claude.ai
These steps are the same in the Claude desktop app and on claude.ai, with no config files to edit. Either way, the server is saved to your Claude account, so you can use it in chat and Cowork.
As a plugin
- Open Customize > Plugins, select Add marketplace, and enter
squaredup/mcp. - Find the plugin for your region (
usoreu) and select Add. - Open the plugin's Connectors tab, add its server, and select Connect to sign in with your SquaredUp account.
The plugin also reaches Claude Code the next time you start a session signed in to the same account, so you don't need to install it there as well. To pick up new versions, select Check for updates on the marketplace or turn on Sync automatically.
As a custom connector
- Open Customize > Connectors and select Add custom connector.
- Enter the server URL for your region (
https://mcp.squaredup.com/mcpfor US,https://eu.mcp.squaredup.com/mcpfor EU) and select Add. - Select Connect to sign in.
The Free plan allows one custom connector.
Team and Enterprise plans
Members can't add custom connectors themselves, so an Owner adds the server for the organization first. In Organization settings > Connectors, select Add, then Custom, choose Web if asked, and enter your region's server URL. Members then find it under Customize > Connectors with a Custom label and select Connect. The same applies to the plugin: if its Connectors tab shows the server as Not added, ask an Owner to add it.
Manual MCP configuration (no plugin)
If you'd rather wire the MCP server up directly, add the entry for your region to your Claude Code MCP config.
US:
{
"mcpServers": {
"squaredup": {
"type": "http",
"url": "https://mcp.squaredup.com/mcp"
}
}
}
EU:
{
"mcpServers": {
"squaredup": {
"type": "http",
"url": "https://eu.mcp.squaredup.com/mcp"
}
}
}
The OAuth flow is identical - the first tool call prompts you to sign in. Skills come from the server itself, so you get them with or without the plugin.
Install for other agents
Every option below adds only your region's MCP server. Skills come with the server, so there is nothing else to install. Sign in with your SquaredUp account in the browser when the agent first connects.
One click
| Agent | US | EU |
|---|---|---|
| Cursor | ||
| VS Code |
VS Code also takes the server from the command line:
code --add-mcp '{"name":"squaredup-us","type":"http","url":"https://mcp.squaredup.com/mcp"}'
VS Code can also install this repo's plugins (an experimental setting). Add the marketplace to your settings, then search the Extensions view for @agentPlugins and install the plugin for your region:
"chat.plugins.marketplaces": ["squaredup/mcp"]
Command line
The commands below are for the US region. For EU, use eu@squaredup, squaredup-eu and https://eu.mcp.squaredup.com/mcp instead.
Codex
Codex reads this repo's marketplace as is:
codex plugin marketplace add squaredup/mcp
codex plugin add us@squaredup
The Codex IDE extension doesn't support plugins. Add the server directly instead; the CLI and the IDE extension share the same config:
codex mcp add squaredup-us --url https://mcp.squaredup.com/mcp
GitHub Copilot CLI
Copilot CLI also reads this repo's marketplace:
copilot plugin marketplace add squaredup/mcp
copilot plugin install us@squaredup
Antigravity CLI
Antigravity CLI installs the region plugin straight from this repo:
agy plugin install https://github.com/squaredup/mcp/tree/main/plugins/us
The plugin is named squaredup-us (squaredup-eu for EU). Install by the region's folder, not the repo root: the root URL installs both regions.
Gemini CLI
Gemini CLI has been replaced by Antigravity CLI for most accounts. If you still use it:
gemini mcp add --transport http squaredup-us https://mcp.squaredup.com/mcp
ChatGPT
In ChatGPT on the web, go to Plugins, select +, then Add custom MCP server. Paste the server URL for your region (https://mcp.squaredup.com/mcp for US, https://eu.mcp.squaredup.com/mcp for EU) and sign in when prompted. Whether you can add custom servers depends on your plan and workspace settings.
Copilot Studio
To use SquaredUp in an agent you build in Copilot Studio, add the server as an MCP tool. You need a Copilot Studio license; a trial can test the agent but can't publish it.
- Open your agent and, on the Build tab, select + next to Tools.
- In Add a tool, select + Add > Model Context Protocol (MCP).
- Fill in the form:
- Server name:
SquaredUp - Server description: the agent uses this to decide when to call SquaredUp, e.g.
Query and manage SquaredUp dashboards, data streams, the knowledge graph, and KPIs. - Server URL:
https://mcp.squaredup.com/mcp(US) orhttps://eu.mcp.squaredup.com/mcp(EU)
- Server name:
- Under Authentication, choose OAuth 2.0 and leave Configuration type as Dynamic (with discovery). There is no client ID or secret to enter. Select Add.
- In Select a connection, open the Connection list, select Create new connection, then Create. Sign in with your SquaredUp account in the pop-up and choose your organization if asked. If no pop-up appears, allow pop-ups for Copilot Studio and select Create again.
- Select Add.
Every SquaredUp tool is on by default. Copilot Studio works best with fewer tools, so select SquaredUp under Tools, turn off Allow all, choose just the tools your agent needs, and select Done. Try the agent on the Preview tab, e.g. ask it to list your SquaredUp workspaces.
To use the agent in Teams and Microsoft 365 Copilot, select + next to Channels, choose Teams + Microsoft 365, and select Add channel, then Publish. The tool's Authentication is End user account by default, so each user signs in with their own SquaredUp account the first time the agent calls a tool.
If you can't add the server, a Power Platform data policy may be blocking custom connectors. Ask your Power Platform admin to allow it.
Other MCP clients
Other MCP clients that support streamable HTTP and OAuth may work, but we've only tested the ones above. Point them at the server URL for your region: https://mcp.squaredup.com/mcp (US) or https://eu.mcp.squaredup.com/mcp (EU). If yours can't sign in, contact SquaredUp support.
Installed the skills with npx skills?
The skills used to be published from this repo for the skills CLI. They now come from the SquaredUp MCP server, so remove the old copies to stop them going stale:
npx skills remove squaredup/mcp -y # project install
npx skills remove squaredup/mcp -g -y # global install
Updating
/plugin marketplace update squaredup
Region plugins are version-pinned, so you receive updates when we publish a new version.
Repository layout
.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
Each region folder is a Claude Code plugin (.claude-plugin/plugin.json) and an Antigravity plugin (.antigravity-plugin/plugin.json). Antigravity can convert a Claude Code plugin on install, but it drops the server URL of an HTTP server, so the region folders carry their own mcp_config.json.
Each manifest has its own version, but US and EU must share it, and every manifest must point at its region's server URL. The Release workflow checks this on every push to main. See CHANGELOG.md for when to bump each one.
Perguntas sobre o MCP SquaredUp
Como adiciono o MCP SquaredUp ao Claude Code?
Execute claude mcp add --transport http mcp https://eu.mcp.squaredup.com/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP SquaredUp ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Como faço a autenticação com o MCP server do SquaredUp?
A autenticação é feita via OAuth pelo navegador usando sua conta existente do SquaredUp, portanto, não há necessidade de gerenciar chaves de API ou tokens manualmente.
Quais tarefas específicas o agente de IA pode realizar com este server?
O server oferece skills integradas para explorar tenants, ler dashboards, consultar data streams e o entity graph, gerenciar KPIs, clonar workspaces e gerenciar usuários.
Como posso saber se minha organização SquaredUp está na região dos EUA ou da UE?
Você pode verificar a URL que utiliza para fazer login no SquaredUp; tenants da UE utilizam um host com 'eu.'.