Claude MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA como o Claude chamem ferramentas externas. O Finn executa um servidor MCP, então você pode conectar o Claude à sua conta Finn e criar agentes de voz descrevendo-os em uma conversa, em vez de preencher o construtor manualmente.

O que este servidor faz. Ele lê seus Finns e cria ou edita rascunhos. Isso é tudo. Ele não pode lançar um Finn, discar um número, gastar seu saldo, mexer em contatos nem ler transcrições — essas ações ficam no painel, de propósito. A seção Escopo abaixo explica o motivo.

Para quem é. Para quem já usa o Claude e prefere descrever um agente a construí-lo clique por clique. Você não precisa escrever código. Se você não usa o Claude, não está perdendo nada — o painel faz tudo o que este servidor oferece, e mais.

Há exatamente duas formas de conectar, e você só precisa de uma:

Escopo — o que o servidor pode e não pode fazer

Isso é intencional e aplicado em dois lugares — o servidor se recusa a expor essas ferramentas, e o backend recusa as requisições correspondentes mesmo que algo as solicite. O motivo é o link do conector descrito abaixo: esse link é, por si só, uma credencial, então o pior que um link vazado pode fazer é ler seus Finns e editar seus rascunhos. Isso é recuperável. "Ligar para meus clientes e gastar meu saldo" não é.

A consequência para você: o Claude cria, você lança. Todo Finn chega como rascunho, você o revisa no painel e aperta o botão.

Passo 1 — Gere uma chave

No painel: Configurações → Integrações → Assistentes de IA (MCP) → Gerar chave.

O nome que você dá à chave é o nome com que o conector aparece dentro do Claude, então use o nome do lugar onde pretende usá-la — "notebook do trabalho", "desktop de casa". Assim, duas chaves aparecem como duas entradas distinguíveis, e não como duas linhas idênticas.

Sua chave começa com finn_mcp_ seguido de uma longa sequência de caracteres. Ela é exibida uma única vez. Copie o que precisar antes de fechar a caixa de diálogo; se perdê-la, revogue a chave e gere outra.

Algumas coisas importantes sobre as chaves:

• Uma chave carrega sua identidade. Um Finn criado com sua chave vai para a sua organização, em seu nome. Se você usar a chave de um colega, o Finn aparecerá na conta dele e você não conseguirá encontrá-lo.
• Não há escopos nem níveis. Toda chave pode fazer tudo o que está na lista "Pode" acima, e nada do que está na lista "Não pode".
• A revogação é imediata. O servidor verifica a chave na sua conta a cada chamada, então uma chave revogada para de funcionar na próxima requisição, e não ao fim de uma sessão.

Etapa 2 — Conectar o Claude

A caixa de diálogo que exibe sua nova chave oferece as duas opções, cada uma com um único botão de copiar. Escolha a que corresponde à forma como você usa o Claude.

Opção 1 — App do Claude (claude.ai ou Claude Desktop)

Esta é a opção que a maioria das pessoas procura. Não há nada para instalar nem editar.

Copie seu link de conector da caixa de diálogo. Ele tem este formato, com a sua chave no final:

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

Depois, no Claude:

1. Abra Personalizar → Conectores, clique em + e escolha Adicionar conector personalizado.
2. Cole o link como URL do servidor MCP remoto e clique em Adicionar. Ele aparece com o nome da sua chave.
3. Em um novo chat, abra + → Conectores, ative o Finn e peça ao Claude para criar um Finn.

Duas observações sobre planos: o plano Free permite um conector personalizado, e nos planos Team e Enterprise apenas um Owner pode adicioná-lo, em Configurações da organização → Conectores. Os demais usuários clicam em Conectar nele.

A contrapartida: um conector personalizado tem apenas um campo de URL, sem lugar para senha, então o link é a credencial. Trate a URL inteira como trataria a senha do seu painel: não a cole em chats, tickets, capturas de tela ou repositórios.

Opção 2 — Claude Code (terminal)

Copie o comando da caixa de diálogo. Ele ocupa uma única linha, então pode ser colado sem problemas no bash, zsh, PowerShell e cmd:

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

1. Cole o comando em um terminal e execute-o.
2. Execute claude.
3. Peça para ele criar um Finn.

Este formato mantém a chave em um cabeçalho em vez da URL, o que o torna a opção mais segura das duas.

Outros clientes MCP

O servidor usa HTTP streamable, não stdio, e não guarda estado: não há sessão para abrir nem expirar. Qualquer cliente compatível com um endpoint MCP via HTTP funciona com qualquer uma das duas formas acima: a chave em um cabeçalho Authorization: Bearer com /mcp, ou a chave como último segmento do caminho de /mcp/<key>.

claude_desktop_config.json não é uma das opções. Esse arquivo configura servidores MCP locais; o servidor do Finn é remoto, por isso é adicionado como conector personalizado.

Etapa 3 — Verificar se funcionou

Pergunte ao Claude:

"Quais Finns eu tenho?"

Se a conexão estiver funcionando, a resposta trará os nomes reais dos seus Finns. Se o Claude disser que não tem essa ferramenta, consulte Solução de problemas abaixo.

As ferramentas

São seis ferramentas, e o Claude escolhe entre elas por conta própria. Você nunca precisa indicar uma diretamente.

Como criar um Finn em uma conversa

Peça o que você quer em linguagem natural. A caixa de diálogo sugere este pedido como ponto de partida:

"Use o conector do Finn para criar um rascunho de Finn chamado Maya que agenda consultas para uma clínica odontológica: simpático, objetivo, em inglês."

Um pedido mais completo seria assim:

"Crie um Finn chamado Skylar que agenda chamadas de demonstração de 15 minutos para nosso time de vendas. Caloroso e objetivo, nunca interrompe e sempre repete a data e o horário para confirmar com quem ligou. Ele só deve falar sobre demonstrações e agendamentos — se alguém perguntar sobre preços, deve oferecer transferir a pessoa para um atendente humano. Use uma voz feminina simpática em inglês."

Para isso, o Claude precisa de quatro informações e vai perguntar se alguma estiver faltando:

Você também pode informar, se quiser, um rótulo de caso de uso, um idioma, uma voz, uma frase de abertura e uma lista de vocabulário personalizado para nomes que ele pronunciaria errado.

Como resposta, você recebe um link para o novo rascunho, o id dele e a organização e a conta em que ele foi criado. A partir daí:

1. Abra o link e revise o rascunho no editor.
2. Peça alterações ao Claude — "encurte a frase de abertura", "adicione um desvio para caixa postal" — e ele edita o próprio rascunho.
3. Quando estiver satisfeito, vincule um número e publique o Finn no dashboard. Veja Deployments.

Uma aba do dashboard que já estava aberta só vai mostrar o novo Finn depois que você recarregá-la.

Vozes

Descreva a voz que você quer — "uma voz masculina calma em inglês" — e o Claude vai buscá-la no catálogo.

Um ponto de atenção: novos Finns são criados na Cartesia, e o id de uma voz de outro provedor é salvo sem nenhum erro, mas falha em uma chamada real. Se você pedir um provedor específico, confira se é o mesmo que o seu Finn realmente usa. A Galeria de vozes tem o catálogo completo.

Segurança

O link do conector é uma senha. Na configuração com um único link, a chave fica na URL, então qualquer pessoa que veja a URL tem o seu acesso. Não tire print dele, não cole em um chat compartilhado e não faça commit dele.

Considere exposta qualquer coisa que você colar. Se uma chave já esteve em uma janela de chat, um ticket ou um e-mail, revogue-a e gere uma nova. Não custa nada.

Revogue em Configurações → Integrações → Assistentes de IA → Revogar. A revogação vale a partir da próxima requisição. Os Finns já criados não são afetados: revogar uma chave não exclui nada do que ela criou.

Uma chave por local. Com chaves separadas para o seu notebook, o seu desktop e cada colega, você pode revogar uma sem afetar as outras, e o nome do conector indica qual é qual.

Confira em qual conta você está. Se você participa de mais de uma organização, pergunte ao Claude "em qual organização do Finn eu estou?" antes de criar qualquer coisa. Os novos Finns vão para a organização em que você entrou mais recentemente.

Solução de problemas

"O Claude não tem nenhuma ferramenta do Finn"

• No app do Claude, abra + → Conectores no chat e verifique se o Finn está ativado. Os conectores são ativados em cada conversa.
• No Claude Code, reinicie o aplicativo: ele lê a configuração de MCP na inicialização.
• No plano Free, verifique se você já não usou seu único espaço de conector personalizado com outra coisa.

"Este link de conector não é válido"

A chave na URL está malformada. Ela precisa estar completa, começando com finn_mcp_, sem nada cortado no final e sem barra ou espaço no fim.

"Este link de conector foi revogado"

Essa chave não existe mais. Gere uma nova e atualize o conector.

"Não foi possível acessar o backend do Finn para verificar sua chave"

É um problema temporário do nosso lado, e não um erro na sua configuração. Tente novamente. Se persistir, entre em contato com o suporte.

O Claude criou um Finn, mas você não o encontra

Quase sempre é a conta errada. Pergunte ao Claude "em qual organização isso foi criado?". A resposta informa a organização e o e-mail ao qual a chave pertence. Se não forem seus, você está usando a chave de outra pessoa.

O Claude diz que não consegue editar um Finn

O Finn já foi lançado. O servidor só edita rascunhos; um Finn ativo é editado no painel.

Próximos passos

• Criando um Finn →: o criador do painel e a função de cada campo de persona.
• Implantações →: como vincular um número e colocar um rascunho no ar.
• Galeria de vozes →: o catálogo completo de vozes.
• Integrações →: webhooks e as demais integrações.