Workspaces

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âmetroObrigatórioDescrição
roleIdsimId do cargo.
memberIdssimmemberIds (list-workspace-members).
workspaceIdnãoOpcional: 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.

ParâmetroObrigatórioDescrição
typesimCanal a conectar
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
namesimNome do cargo.
permissionssimChaves do catálogo de permissões.
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
roleIdsimId do cargo.
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
emailsimE-mail da pessoa
roleIdsimCargo (roleId de list-workspace-members)
messagenãoMensagem que vai no convite (até 2.000)
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
memberIdsimmemberId de list-workspace-members OU inviteId de pendingInvites.
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
inviteIdsimId do convite pendente.
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
roleIdsimId do cargo.
memberIdsimmemberId (list-workspace-members).
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
namenãoNovo nome (até 100)
descriptionnãoNova descrição (até 500)
workspaceIdnãoOpcional: 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âmetroObrigatórioDescrição
roleIdsimId do cargo.
namenãoNovo nome.
permissionsnãoNova lista inteira de permissões.
workspaceIdnãoOpcional: precisa ser o workspace do token

Nesta página