---
title: MCP
description: >-
Conecte o Claude, o Cursor ou qualquer cliente MCP ao seu workspace da Ali
para que ele possa ler seus clientes, projetos, tarefas e documentos, e agir
sobre eles.
sidebar:
label: Visão geral
icon: layers
---
MCP, abreviação de [Model Context Protocol](https://modelcontextprotocol.io), é o padrão que permite que um cliente de IA converse com um sistema externo. A Ali AI roda um servidor MCP para o seu workspace, então qualquer cliente que fale esse protocolo pode ver seus clientes, projetos, tarefas e documentos, e alterá-los quando você permitir.
Na prática, isso significa que você para de copiar contexto para um chat. Você abre o Claude, pergunta "o que está atrasado no Studio esta semana?", e a resposta vem do seu workspace real. Você pede para mover uma tarefa, e a tarefa se move.
Tudo começa na tela **Connect MCP**, que você acessa pela barra superior do app.
O painel no topo sempre traz os dois valores de que você precisa: a **URL do servidor** do seu workspace, e uma prévia mascarada do seu **token de acesso**. Copie qualquer um dos dois com o botão à direita de cada linha.
## Duas formas de conectar
Não existe uma única resposta certa aqui. Escolha a que combina com onde o cliente roda.
Faça login pelo seu editor e aprove o acesso. Nada para copiar, nada para armazenar. Esse é o caminho recomendado para o Claude, o Cursor, o Windsurf e qualquer outro app com um painel de conectores.
Para CLIs, pipelines de CI e configurações headless. Você cria um token de API na Ali e cola em um comando ou em um arquivo de configuração.
A diferença está em onde a credencial vive. Com o one-click connect, a Ali e o seu cliente trocam ela por você e você nunca vê um token. Com um token de API, você guarda o segredo e decide onde ele fica armazenado, que é exatamente o que um servidor de build precisa.
## O que um cliente conectado pode fazer
O servidor expõe seu workspace agrupado por recurso, e cada grupo tem ferramentas de leitura e ferramentas de escrita:
| Recurso | O que o cliente consegue acessar |
| --- | --- |
| Tarefas | Listar, buscar, abrir, criar, atualizar, arquivar e excluir tarefas, além de quadros e status |
| Projetos | Listar, abrir, criar, atualizar e excluir projetos, e ler seus membros |
| Clientes | Listar e abrir contas, ler e escrever notas, atualizar status |
| Documentações | Listar, abrir, criar, atualizar e excluir documentos e suas páginas |
| Base de conhecimento | Buscar na [base de conhecimento](/knowledge-base) e ver o que há nela |
| Dashboard | Ler a visão geral do workspace, suas tarefas e o que está atrasado. Somente leitura |
Um cliente só vê os grupos que você concedeu. Se um token não tiver acesso a Clientes, as ferramentas de clientes simplesmente não existem para esse cliente.
## Quem pode conectar
Qualquer membro do workspace pode conectar um cliente à própria conta. O cliente age como esse membro, então ele vê o que o membro vê e nada mais. Conexões e tokens são listados por workspace, então um admin pode olhar as abas **API tokens** e **Connected apps** a qualquer momento e revogar o que não deveria estar lá.
## Para onde ir agora
O fluxo de quatro etapas, a tela de consentimento, e como gerenciar uma conexão depois.
Crie um token, defina seu escopo, e cole no seu CLI ou arquivo de configuração.
Como funciona o acesso de leitura e edição, e como manter uma conexão restrita.
O mesmo workspace, mas rodando em uma agenda sem você precisar pedir.