MCP: Workspace y equipo
Miembros, invitaciones, nombre del workspace, enlaces de conexión y aprobaciones por el MCP. 15 herramientas. Para Claude, Cursor y otros clientes MCP.
Herramientas de esta área, generadas del código del servidor. Las descripciones vienen de ese código, en portugués. Para conectar, mira el MCP de XBASE.
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".
| Parámetro | Obligatorio | Descripción |
|---|---|---|
roleId | sí | Id do cargo. |
memberIds | sí | 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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
type | sí | 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".
| Parámetro | Obligatorio | Descripción |
|---|---|---|
name | sí | Nome do cargo. |
permissions | sí | 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".
| Parámetro | Obligatorio | Descripción |
|---|---|---|
roleId | sí | 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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
email | sí | E-mail da pessoa |
roleId | sí | 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.
Sin parámetros.
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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
memberId | sí | 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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
inviteId | sí | 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".
| Parámetro | Obligatorio | Descripción |
|---|---|---|
roleId | sí | Id do cargo. |
memberId | sí | 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.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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".
| Parámetro | Obligatorio | Descripción |
|---|---|---|
roleId | sí | Id do cargo. |
name | no | Novo nome. |
permissions | no | Nova lista inteira de permissões. |
workspaceId | no | Opcional: precisa ser o workspace do token |