MCP: Workspace and team
Members, invites, workspace name, connection links and pending approvals through the MCP. 15 tools. For Claude, Cursor and other MCP clients.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
assign-workspace-role
Adiciona um ou mais membros a um cargo do workspace (promover). roleId vem de list-workspace-roles, memberIds vêm de list-workspace-members. Exige token MCP com "Permitir convidar e gerenciar membros".
| Parameter | Required | Description |
|---|---|---|
roleId | yes | Id do cargo. |
memberIds | yes | memberIds (list-workspace-members). |
workspaceId | no | Opcional: precisa ser o workspace do token |
create-connection-link
Link para conectar um canal ao workspace (instagram, facebook_page, whatsapp, tiktok, youtube, meta_ads ou google_ads), para mandar a quem tem o acesso à conta. TikTok e YouTube: link de autorização direto (vale 30 minutos e uma conexão; abre em qualquer navegador e grava no workspace do token). Os outros: a tela de conexão da XBASE, que abre no workspace selecionado de quem entrar (o retorno diz qual selecionar). O login no Facebook, Google ou TikTok continua sendo da pessoa.
| Parameter | Required | Description |
|---|---|---|
type | yes | Canal a conectar |
workspaceId | no | Opcional: precisa ser o workspace do token |
create-workspace-role
Cria um cargo customizado no workspace do token com nome e lista de permissões (list-workspace-permissions). Exige token MCP com "Permitir convidar e gerenciar membros".
| Parameter | Required | Description |
|---|---|---|
name | yes | Nome do cargo. |
permissions | yes | Chaves do catálogo de permissões. |
workspaceId | no | Opcional: precisa ser o workspace do token |
delete-workspace-role
Apaga um cargo customizado do workspace. Cargo padrão/dono não apaga. Exige "Permitir convidar e gerenciar membros".
| Parameter | Required | Description |
|---|---|---|
roleId | yes | Id do cargo. |
workspaceId | no | Opcional: precisa ser o workspace do token |
invite-workspace-member
Convida uma pessoa para o workspace por e-mail, com um cargo (roleId de list-workspace-members). Quem já tem conta na XBASE entra na hora e recebe um aviso; quem não tem recebe o convite por e-mail. Dá acesso ao workspace: só funciona com token MCP que tenha "Permitir convidar e gerenciar membros" marcado em Acesso MCP (vale também para o token "todas as ferramentas") e com o cargo "Gerenciar membros" de quem criou o token. Até 100 convites por hora por pessoa.
| Parameter | Required | Description |
|---|---|---|
email | yes | E-mail da pessoa |
roleId | yes | Cargo (roleId de list-workspace-members) |
message | no | Mensagem que vai no convite (até 2.000) |
workspaceId | no | Opcional: precisa ser o workspace do token |
list-my-workspaces
Workspaces em que este token age, com o id para o workspaceId das outras ferramentas. Token da conta ("Vale para todos os meus workspaces"): todos em que você é membro ativo, com o nome, o slug, os seus cargos, se o MCP age ali (canUseMcp: precisa do cargo "Gerenciar integrações") e se o token convida (canInvite). Token de workspace: só o dele. Não precisa de workspaceId.
No parameters.
list-pending-approvals
O que espera uma pessoa aprovar ou resolver no workspace, com o link de cada pendência: regras de preço, comissão, pagamento ou exclusividade em PENDING_APPROVAL, termos de parceiro a aprovar, rascunhos de anúncio (Anúncios → Avisos) e contas de anúncio com saldo baixo ou acabando (recarga e limite são feitos na Meta). Só leitura: aprovar continua sendo de quem tem o cargo, na tela.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
list-workspace-members
Membros ativos do workspace (userId, nome, e-mail, cargos), os cargos que existem (roleId para invite-workspace-member), os convites pendentes e se este token pode convidar (tokenCanInvite). userId é o que vai em assigneeUserId de marketing_update_action e em ownerUserId dos projetos.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
list-workspace-permissions
Catálogo de permissões disponíveis na XBASE agrupadas por área (as mesmas que a tela de Cargos mostra). Use as chaves em create-workspace-role e update-workspace-role. Só leitura.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
list-workspace-roles
Cargos customizáveis do workspace do token, com id, nome, posição, se é padrão/dono, nº de membros e lista de permissões do cargo. Use o roleId em assign-workspace-role e invite-workspace-member.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
remove-workspace-member
Remove um membro do workspace do token OU cancela um convite pendente (o backend trata os dois pelo mesmo id — é como a UI faz: o botão "Cancelar convite" dos convites e "Remover" dos membros chamam a mesma rota). Não apaga a conta global da pessoa na XBASE: ela só deixa de fazer parte deste workspace. memberId: id de membro ou inviteId de list-workspace-members (pendingInvites). Exige token MCP com "Permitir convidar e gerenciar membros" marcado em Acesso MCP e o cargo "Gerenciar membros" de quem criou o token.
| Parameter | Required | Description |
|---|---|---|
memberId | yes | memberId de list-workspace-members OU inviteId de pendingInvites. |
workspaceId | no | Opcional: precisa ser o workspace do token |
resend-workspace-invite
Reenvia um convite pendente do workspace por e-mail. inviteId vem do campo id de list-workspace-members (pendingInvites). Até 100 por hora por pessoa. Exige token MCP com "Permitir convidar e gerenciar membros" ou listando invite-workspace-member.
| Parameter | Required | Description |
|---|---|---|
inviteId | yes | Id do convite pendente. |
workspaceId | no | Opcional: precisa ser o workspace do token |
unassign-workspace-role
Tira um membro de um cargo do workspace (rebaixar). Exige token MCP com "Permitir convidar e gerenciar membros".
| Parameter | Required | Description |
|---|---|---|
roleId | yes | Id do cargo. |
memberId | yes | memberId (list-workspace-members). |
workspaceId | no | Opcional: precisa ser o workspace do token |
update-workspace
Renomeia o workspace do token e/ou muda a descrição. O endereço (slug) não muda. Exige o cargo "Gerenciar workspace" de quem criou o token.
| Parameter | Required | Description |
|---|---|---|
name | no | Novo nome (até 100) |
description | no | Nova descrição (até 500) |
workspaceId | no | Opcional: precisa ser o workspace do token |
update-workspace-role
Altera nome e/ou permissões de um cargo do workspace. Só campos enviados mudam; permissions troca a lista inteira (leia antes com list-workspace-roles). Exige "Permitir convidar e gerenciar membros".
| Parameter | Required | Description |
|---|---|---|
roleId | yes | Id do cargo. |
name | no | Novo nome. |
permissions | no | Nova lista inteira de permissões. |
workspaceId | no | Opcional: precisa ser o workspace do token |