# Conectores do Claude: o que são e como adicionar um

[Canonical HTML page](https://gradiently.design/pt-pt/guide/claude-connectors)

Um conector dá mãos ao Claude: ele pode pesquisar os teus ficheiros, ler um projeto ou criar um design numa ferramenta real, em vez de te descrever como o fazer. Eis como funcionam e como adicionar um em poucos minutos.

## The short version

- Os conectores do Claude ligam-no a serviços externos para que ele possa pesquisar, ler e agir neles durante uma conversa.
- Os conectores assentam no Model Context Protocol, um padrão aberto para ligar assistentes de IA a ferramentas e dados.
- Os conectores remotos correm na web e adicionam-se por URL ou a partir de um diretório, enquanto os servidores locais correm no teu próprio computador.
- O Claude pede autorização antes de usar as ferramentas de um conector, e podes permitir uma ação uma vez ou sempre.
- As funcionalidades de conectores que podes usar dependem do teu plano Claude e, nas organizações, do que um proprietário ativou.

Os **conectores do Claude** ligam-no a serviços externos para que, durante uma conversa, ele os possa pesquisar, ler e neles agir, por exemplo criando um documento ou um design. Cada conector é um servidor MCP: um pequeno serviço web que fala o Model Context Protocol, aberto, e diz ao Claude que ferramentas oferece. Adicionas um a partir do diretório de conectores do Claude ou, no caso de um conector personalizado, colando o URL do servidor nas definições do Claude; depois inicias sessão no serviço e escolhes o que o Claude pode fazer lá.

## Como funcionam os conectores

Quando um conector está ativo, o Claude recebe a lista das suas ferramentas, cada uma com nome, descrição e os dados de que precisa. Quando o teu pedido corresponde a uma, o Claude preenche esses dados e pede a tua autorização para a executar. O serviço faz o trabalho e devolve um resultado, que o Claude lê e usa na resposta. A especificação e uma lista de servidores de exemplo estão em [modelcontextprotocol.io](https://modelcontextprotocol.io), e [o que é o MCP](https://gradiently.design/pt-pt/guide/what-is-mcp) explica a ideia em palavras simples.

| Tipo | Onde corre | Como o adicionas | Uso típico |
| --- | --- | --- | --- |
| Conector do diretório | Nos servidores do serviço | Escolhe-o na lista do Claude e inicia sessão | Aplicações populares e armazenamento de ficheiros |
| Conector remoto personalizado | Na web, num URL | Cola o URL do servidor nas definições | Qualquer serviço com servidor MCP |
| Servidor local | No teu próprio computador | Uma extensão de ambiente de trabalho ou um ficheiro de configuração | Ficheiros e aplicações da tua máquina |
| Servidor do Claude Code | Local ou remoto | `claude mcp add` no terminal | Desenvolvimento e automação |

Quatro formas de o Claude se ligar a ferramentas. Os conectores remotos são os mais fáceis de partilhar e de manter atualizados.

## Como adicionar um conector do diretório

1. **Abre as definições de conectores** No Claude na web ou na aplicação de ambiente de trabalho, abre as Definições e procura Conectores.
2. **Explora o diretório** Escolhe o serviço que queres. Cada entrada explica a que pode aceder o conector.
3. **Liga e inicia sessão** O Claude leva-te ao serviço para iniciares sessão e aprovares o acesso e depois devolve-te ao Claude.
4. **Ativa-o numa conversa** Numa conversa, liga o conector no menu de ferramentas. Deixa os conectores sem uso desligados para o Claude escolher entre menos ferramentas.

## Como adicionar um conector personalizado

Um conector personalizado é qualquer servidor MCP remoto que não esteja no diretório, incluindo os de ferramentas mais pequenas ou da tua própria empresa. Em Definições, em Conectores, escolhe adicionar um conector personalizado, dá-lhe um nome e cola o URL do servidor. Se o servidor exigir início de sessão, o Claude guia-te. Nos planos Team e Enterprise, pode ser preciso que um proprietário adicione ou permita primeiro o conector para a organização. O centro de ajuda do Claude, da Anthropic, tem os passos atuais para cada plano, e vale a pena consultá-lo, porque os menus mudam.

> **Alguns servidores usam chaves de API** Nem todos os servidores iniciam sessão pelo navegador. Alguns esperam uma chave de API enviada num cabeçalho Authorization. Se o formulário de conectores da tua aplicação Claude não tem onde a colocar, usa o Claude Code ou segue o guia de configuração do próprio serviço.

## Adicionar um servidor MCP no Claude Code

O Claude Code adiciona servidores a partir do terminal e pode enviar um cabeçalho personalizado, o que o torna o caminho mais simples para servidores que usam chaves de API. Guarda a chave numa variável de ambiente para nunca ficar no histórico da shell nem num ficheiro partilhado.

```bash
# A remote server that signs in through the browser
claude mcp add --transport http example https://example.com/mcp

# A remote server that expects an API key
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

# Check what is connected
claude mcp list
```

Adicionar servidores remotos ao Claude Code. Troca o URL de exemplo pelo do servidor que queres.

## Um exemplo: o Claude a fazer designs

O design mostra o que um conector muda. Sozinho, o Claude pode sugerir um título e descrever um layout. Ligado ao Gradiently, pode pesquisar Marks, ler a tua marca e criar designs que abrem no Studio, prontos para verificares e exportares. Um proprietário ou administrador do espaço de trabalho cria uma chave de API com âmbito no Gradiently, em Definições › API e agentes, escolhendo exatamente o que o assistente pode fazer, e a [documentação para programadores](https://gradiently.design/pt-pt/developers/mcp) trata da configuração. Os designs que o assistente faz assim não gastam créditos do Gradiently.

Um story vertical de Instagram a anunciar abertura até tarde às sextas, até à meia-noite e cozinha até às onze

Um story que o Claude fez a partir de uma frase através de um conector de design: texto real, o Mark da marca, o formato exato de 1080×1920.

[Desenhar com o Claude através do Gradiently](https://gradiently.design/pt-pt/guide/design-with-claude) percorre uma conversa completa, de um story a três formatos.

## Manter os conectores seguros

### Evita

- Conectores personalizados de fontes que não consegues verificar
- Escolher «permitir sempre» para ações que apagam ou gastam
- Uma chave com todas as permissões, partilhada em todo o lado
- Deixar todos os conectores ligados em todas as conversas

### Faz

- Servidores publicados pelo próprio serviço
- Permitir uma vez até confiares no comportamento de uma ferramenta
- Uma chave com âmbito por local, com o nome desse local
- Ativar só os conectores de que a conversa precisa

Um conector pode ler o que o Claude lhe envia e agir com o acesso que lhe deste. O conteúdo que um conector vai buscar, como uma página web ou um ficheiro partilhado, também pode conter instruções, por isso lê o que o Claude propõe fazer a seguir em vez de aprovares em piloto automático.

## Resolver problemas de um conector

| Sintoma | Causa provável | Tenta |
| --- | --- | --- |
| Conector adicionado, não aparecem ferramentas | Não está ativo nesta conversa | Liga-o no menu de ferramentas |
| Erro de não autorizado ou 401 | Chave ou início de sessão em falta ou revogado | Volta a ligar ou cria uma chave nova |
| O Claude ignora o conector | O pedido não corresponde a nenhuma ferramenta | Indica o serviço e o resultado na mensagem |
| Falta a opção de adicionar conectores personalizados | Plano ou definições da organização | Pergunta ao proprietário da tua organização Claude ou consulta o centro de ajuda |

Quatro problemas comuns ao adicionar um conector.

O ChatGPT tem um sistema semelhante, descrito em [aplicações do ChatGPT](https://gradiently.design/pt-pt/guide/chatgpt-apps), [ligar um assistente de IA](https://gradiently.design/pt-pt/guide/connect-ai-assistant) trata do Gradiently em vários clientes, e [servidores MCP para designers](https://gradiently.design/pt-pt/guide/mcp-servers-for-designers) sugere que tipos ligar primeiro.

## FAQ

### O que são os conectores do Claude?

Integrações que deixam o Claude pesquisar, ler e agir em serviços externos durante uma conversa. Cada um é um servidor MCP que oferece ao Claude um conjunto de ferramentas.

### Como adiciono um conector personalizado ao Claude?

Abre as Definições, vai a Conectores, escolhe adicionar um conector personalizado e cola o URL do servidor MCP remoto; depois inicia sessão, se pedido. Alguns planos exigem que um proprietário o permita primeiro.

### Qual é a diferença entre um servidor MCP local e um remoto?

Um servidor local corre no teu computador e pode aceder aos teus ficheiros e aplicações. Um servidor remoto corre na web, num URL, por isso funciona em qualquer dispositivo.

### O Claude consegue fazer designs com um conector?

Sim, com uma ferramenta de design que ofereça um servidor MCP. O Gradiently deixa o Claude criar designs na tua marca que abrem no Studio para edição.