MCP: Workspace e equipe
Membros, convites, nome do workspace, links de conexão e aprovações pendentes pelo MCP. 15 ferramentas. Para o Claude, o Cursor e outros clientes MCP.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da 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 | Obrigatório | Descrição |
|---|---|---|
roleId | sim | Id do cargo. |
memberIds | sim | memberIds (list-workspace-members). |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
type | sim | Canal a conectar |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
name | sim | Nome do cargo. |
permissions | sim | Chaves do catálogo de permissões. |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
roleId | sim | Id do cargo. |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
email | sim | E-mail da pessoa |
roleId | sim | Cargo (roleId de list-workspace-members) |
message | não | Mensagem que vai no convite (até 2.000) |
workspaceId | não | 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.
Sem 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 | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
memberId | sim | memberId de list-workspace-members OU inviteId de pendingInvites. |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
inviteId | sim | Id do convite pendente. |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
roleId | sim | Id do cargo. |
memberId | sim | memberId (list-workspace-members). |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
name | não | Novo nome (até 100) |
description | não | Nova descrição (até 500) |
workspaceId | não | 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 | Obrigatório | Descrição |
|---|---|---|
roleId | sim | Id do cargo. |
name | não | Novo nome. |
permissions | não | Nova lista inteira de permissões. |
workspaceId | não | Opcional: precisa ser o workspace do token |