Workspaces

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".

ParameterRequiredDescription
roleIdyesId do cargo.
memberIdsyesmemberIds (list-workspace-members).
workspaceIdnoOpcional: precisa ser o workspace do token

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.

ParameterRequiredDescription
typeyesCanal a conectar
workspaceIdnoOpcional: 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".

ParameterRequiredDescription
nameyesNome do cargo.
permissionsyesChaves do catálogo de permissões.
workspaceIdnoOpcional: 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".

ParameterRequiredDescription
roleIdyesId do cargo.
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
emailyesE-mail da pessoa
roleIdyesCargo (roleId de list-workspace-members)
messagenoMensagem que vai no convite (até 2.000)
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
memberIdyesmemberId de list-workspace-members OU inviteId de pendingInvites.
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
inviteIdyesId do convite pendente.
workspaceIdnoOpcional: 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".

ParameterRequiredDescription
roleIdyesId do cargo.
memberIdyesmemberId (list-workspace-members).
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
namenoNovo nome (até 100)
descriptionnoNova descrição (até 500)
workspaceIdnoOpcional: 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".

ParameterRequiredDescription
roleIdyesId do cargo.
namenoNovo nome.
permissionsnoNova lista inteira de permissões.
workspaceIdnoOpcional: precisa ser o workspace do token

On this page