Conectar o Claude ao digna¶

Este guia conecta o Claude ao digna MCP Server. Você precisa do endpoint MCP da sua instalação do digna e de uma chave de API, conforme descrito na Visão Geral de Agentes de IA.

Os exemplos usam https://digna.example.com/mcp como endpoint. Substitua-o pelo seu.

Escolher Como Conectar¶

Para uma instalação do digna que roda dentro da rede da sua empresa, use o Claude Code ou o Claude Desktop com uma ponte local.

Claude Code¶

1. Adicionar o Servidor¶

Coloque a chave de API em uma variável de ambiente e depois adicione o servidor:

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

O seu shell substitui $DIGNA_API_KEY quando você executa o comando, então o Claude Code armazena a chave na própria configuração.

--scope define onde o servidor fica disponível:

2. Compartilhar o Servidor com a Sua Equipe (Opcional)¶

Para dar a todos de um projeto o mesmo servidor, adicione um arquivo .mcp.json à raiz do projeto. Não escreva a chave no arquivo. O Claude Code preenche ${DIGNA_API_KEY} a partir do ambiente de cada pessoa:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Cada pessoa define DIGNA_API_KEY com a própria chave. Na primeira vez que o Claude Code encontra o arquivo, ele pergunta se deve usar os servidores definidos nele.

3. Verificar a Conexão¶

No seu shell:

claude mcp list

O servidor digna precisa mostrar ✔ Connected. Dentro de uma sessão do Claude Code, execute /mcp para ver o servidor e as suas ferramentas.

Claude Desktop com uma Ponte Local¶

O arquivo de configuração do Claude Desktop inicia servidores MCP locais na sua máquina. Uma pequena ponte, o pacote de código aberto mcp-remote, roda ali e encaminha cada requisição ao endpoint do digna com a sua chave de API. Como a ponte roda na sua máquina, isso funciona com o digna dentro da rede da sua empresa.

1. Instalar o Node.js¶

A ponte precisa do Node.js 18 ou posterior. O Claude Desktop usa a versão do Node.js instalada no seu sistema. Verifique-a com:

node --version

2. Editar o Arquivo de Configuração¶

Abra claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione o servidor digna. Se o arquivo já tiver uma seção mcpServers, adicione a entrada digna a ela:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. Reiniciar o Claude Desktop¶

Encerre o Claude Desktop completamente e inicie-o novamente. Em um novo chat, clique em + e abra Connectors: digna precisa aparecer na lista e estar ativado.

Conector Personalizado¶

Um conector personalizado disponibiliza o digna no claude.ai, no Claude Desktop e nos aplicativos móveis do Claude sem nenhuma configuração local. É a nuvem da Anthropic que se conecta ao endpoint, então isso só funciona quando:

• O endpoint do digna está acessível pela internet via HTTPS
• A sua organização do Claude tem a opção Request headers na caixa de diálogo Add custom connector. A Anthropic a oferece como beta para um conjunto limitado de organizações

1. Abrir as Configurações de Conectores¶

• Planos Free, Pro, Max e Ultra: vá para Customize > Connectors e clique em Add custom connector.
• Planos Team e Enterprise: um Owner vai para Organization settings > Connectors, clica em Add, depois em Custom, e escolhe Web se for perguntado o tipo.

2. Inserir os Detalhes do Conector¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: escolha authorization como nome do cabeçalho, insira Bearer <api key> como valor, incluindo a palavra Bearer e o espaço, e marque-o como Required.
4. Clique em Add.

Nos planos Team e Enterprise, os membros então se conectam em Customize > Connectors, onde o conector traz o rótulo Custom.

O Claude não permite alterar o cabeçalho de um conector existente. Para usar uma nova chave, remova o conector e adicione-o novamente.

Resolução de Problemas do Claude¶

claude mcp list Mostra Failed to connect¶

Execute claude mcp get digna para ver o motivo. Um 401 significa que a chave foi rejeitada; veja 401 Unauthorized. O Claude Code também avisa sobre espaços ou uma quebra de linha no início ou no fim da chave, que muitas vezes aparecem ao copiá-la.

O digna Não Aparece no Claude Desktop¶

• Verifique se o Node.js 18 ou posterior está instalado: node --version.
• Verifique se claude_desktop_config.json é um JSON válido. Uma vírgula faltando impede que todos os servidores do arquivo sejam carregados.
• Encerre o Claude Desktop completamente, não apenas a janela, e inicie-o novamente.

O Conector Personalizado Não Consegue Alcançar o Servidor¶

A nuvem da Anthropic não consegue alcançar o endpoint. Verifique se ele está acessível pela internet via HTTPS com um certificado válido, ou conecte-se pelo Claude Code.

Veja Também¶

• Visão Geral de Agentes de IA: endpoint, chave de API, segurança e resolução de problemas geral
• Gemini: conectar o Antigravity ou o Gemini CLI
• digna Agentic: o que os agentes de IA podem fazer com o digna