Endpoint e autorização
POST https://teamwide.app/mcpO endpoint requer um token OAuth do tipo Bearer. As informações para descobrir o servidor de autorização estão disponíveis em /.well-known/oauth-authorization-server. Os pedidos sem um token Bearer válido devolvem o estado 401.
Solicite o âmbito read para consultar ou read write para editar. Cada ferramenta verifica o âmbito necessário e as permissões atuais do espaço de trabalho e do quadro. Se um token existente não tiver o âmbito necessário, é preciso voltar a estabelecer a ligação.
Ferramentas disponíveis
O servidor disponibiliza atualmente a identificação e a listagem de espaços de trabalho, operações com quadros, coleções, membros, contentores e conectores, instantâneos de quadros e exportação para PNG/PDF. As ferramentas que alteram dados seguem as mesmas regras relativas a contas, subscrições e permissões da interface web.
Trabalhar em conjunto num quadro
Vários agentes podem trabalhar no mesmo quadro em simultâneo. As alterações são apresentadas em tempo real aos participantes com sessão iniciada. As verificações de versão assinalam conflitos em vez de substituírem alterações sem aviso.
Trabalhar na tela
Comece com whoami e account_list e, em seguida, passe o account_id selecionado às operações do quadro. Utilize explore_board para obter uma visão geral resumida e get_containers para consultar os detalhes selecionados. Carregue get_canvas_guide uma vez para consultar as regras de coordenadas, os limites e os exemplos completos.
Crie objetos e setas relacionados com apply_canvas_changes. Se uma operação falhar, são anuladas todas as alterações do lote completo. Após uma resposta incerta, reutilize o mesmo identificador do pedido e os mesmos dados para evitar objetos duplicados. Para editar, passe a versão mais recente do objeto; as alterações simultâneas geram um conflito em vez de serem sobrepostas.
Utilize patch_container_content para substituições exatas de texto, create_image_upload e insert_uploaded_image para imagens locais e get_board_image para verificar a disposição resultante. Os esquemas das ferramentas descrevem os valores aceites, os formatos de saída e os limites de paginação.
Se uma imagem já tiver um URL público, passe esse URL direto como content a create_container com content_type: image. O servidor obtém e anexa o ficheiro. Apenas o URL é transmitido através de MCP. Utilize update_container com um novo URL para substituir uma imagem; os ficheiros locais são carregados diretamente para o URL assinado.
Configuração do cliente
Configure https://teamwide.app/mcp como endpoint MCP remoto num cliente que suporte a descoberta de servidores de autorização OAuth e PKCE. Autorize o acesso no Teamwide. Utilize account_list para selecionar um espaço de trabalho e passe o respetivo account_id às operações seguintes nos quadros.