> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ligar outras ferramentas

> Usa as tuas ferramentas preferidas através dos respetivos servidores MCP

Se a ferramenta com que trabalhas não estiver na [lista de integrações](/docs/pt/integrations/overview), muitas vezes podes ligá-la tu. Muitas apps oferecem o seu próprio servidor [MCP](https://modelcontextprotocol.io): Linear, Notion, Sentry, Supabase, PostHog, Zapier e centenas de outras. Liga-as no Macaly e o agente pode usá-las enquanto constrói os teus projetos, por exemplo ler tarefas do Linear, ir buscar conteúdo ao Notion ou verificar erros no Sentry.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

Os servidores ligados são pessoais e só os teus chats os usam. Os restantes membros do espaço de trabalho ligam os deles.

## Adicionar um servidor

Abre **Definições → Servidores MCP** e clica em **Adicionar servidor**.

O mais rápido é escolher em **Servidores populares**. A lista tem mais de quarenta servidores prontos, filtrados por categorias como **Desenvolvimento**, **Produtividade**, **Conteúdo**, **Dados e IA**, **Comércio**, **Análises** e **Comunicação**. Escolhe um e o endereço e o método de início de sessão são preenchidos por ti.

Para qualquer outro servidor, escolhe **Avançado** e preenche:

* **Nome**: como o servidor aparece na tua lista, por exemplo «O meu Linear».
* **URL do servidor**: o endereço do servidor.
* **Transporte**: **Streamable HTTP** para os servidores atuais. Escolhe **SSE (legado)** só se a documentação do servidor o pedir.
* **Autenticação**: **OAuth (iniciar sessão)** se o servidor te autenticar pelo navegador, ou **Cabeçalhos API** se esperar uma chave. Os cabeçalhos são opcionais e são enviados com cada pedido, por exemplo `Authorization: Bearer …`.

Clica em **Testar ligação**. O Macaly liga-se ao servidor e mostra quantas ferramentas encontrou. Com OAuth, abre primeiro uma janela de início de sessão. Se não aparecer nada, permite pop-ups para macaly.com. Depois clica em **Guardar alterações**.

<Note>
  Os valores dos cabeçalhos são guardados de forma que o Macaly nunca mais os mostra. Para os alterares, acrescenta linhas novas, ou deixa os campos vazios para manteres o que está guardado.
</Note>

## Escolher que ferramentas o agente pode usar

Depois da primeira ligação bem-sucedida, as ferramentas do servidor aparecem por baixo dele, agrupadas em **Ferramentas só de leitura**, **Ferramentas de escrita** e **Ferramentas destrutivas**. Cada ferramenta tem o seu interruptor, e **Ativar todas** e **Desativar todas** abrangem o servidor inteiro.

Para começar, recomendamos deixar ligadas apenas as ferramentas só de leitura. Liga as de escrita ou destrutivas quando quiseres que o agente altere alguma coisa nesse serviço. O agente só vê as ferramentas que ativaste.

## Estado do servidor

Cada servidor mostra o seu estado:

* **Conectado**: pronto a usar.
* **Início de sessão necessário**: a sessão OAuth expirou ou nunca foi concluída. Clica em **Tentar novamente** e inicia sessão. As ferramentas ficam ocultas até concluíres o início de sessão.
* **Inacessível**: o servidor não respondeu da última vez que o Macaly tentou. **Último erro** mostra o que correu mal, e **Tentar novamente** repete a tentativa.

Usa o interruptor **Ativado** para esconderes temporariamente um servidor do agente sem o eliminares. **Desconectar** apaga um início de sessão guardado e **Eliminar servidor** remove o servidor e as respetivas credenciais.

## Usar um servidor ligado

A forma como trabalhas com o agente não muda. Menciona a ferramenta e o que precisas, e o agente escolhe sozinho a ferramenta MCP correspondente.

**Exemplos de prompts:**

```
Encontra as issues abertas do meu projeto no Linear «Relançamento do
site» e cria uma página pública de roadmap que as liste por estado.
```

```
Vai buscar a página «Equipa» do nosso Notion e transforma-a numa
página Sobre nós com um cartão para cada pessoa.
```

```
Vê no Sentry os erros da página de checkout da última semana e corrige
o mais frequente.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.