> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ligar assistentes de IA à CloudTalk (MCP)

> Ligue assistentes de IA como o Claude e o Cursor à sua conta CloudTalk

> [!NOTE]
>
> O servidor MCP da CloudTalk liga assistentes de IA como o Claude e o Cursor à sua conta CloudTalk. Depois de o ligar, pode pedir ao assistente, em linguagem simples, que pesquise chamadas, leia transcrições, atualize contactos, envie SMS ou crie AI Voice Agents.

**Nível de utilizador:** Admin

***

## O que é o MCP?

O MCP (Model Context Protocol) é uma norma aberta que permite aos assistentes de IA trabalhar com ferramentas empresariais. Liga a CloudTalk uma vez e, a partir daí, o assistente pode utilizar a CloudTalk em seu nome. Por exemplo, pode pedir: *«Resume as chamadas de ontem com a Acme e adiciona uma etiqueta às que mencionam preços.»*

A sua aplicação de IA pede-lhe que aprove as ações que enviam mensagens, fazem chamadas ou alteram dados antes de serem executadas, a não ser que o próprio utilizador ou um administrador tenham permitido que uma ferramenta seja executada sem pedir confirmação. O assistente não consegue eliminar contactos, chamadas nem gravações.

## Quem o pode utilizar

O MCP está disponível no **plano Essential e superiores**. Algumas ferramentas exigem mais:

* **Os insights de IA** (resumos, sentimento, tópicos, transcrições) exigem a Conversation Intelligence.
* **As ferramentas de campanhas** exigem o add-on do novo Sales Dialer.

## Que assistentes de IA funcionam atualmente

Existem duas formas de ligar, e a CloudTalk suporta ambas:

* **Iniciar sessão com a CloudTalk:** inicia sessão com a sua conta de administrador da CloudTalk e aprova o acesso. Não há nenhuma chave para copiar e o assistente age em seu nome.
* **Chave de API:** cola uma chave de API da CloudTalk nas definições do assistente. O assistente age em nome da sua empresa.

| Assistente de IA | Iniciar sessão com a CloudTalk | Chave de API |
| - | - | - |
| Claude.ai, Claude Desktop, aplicação móvel do Claude | Sim | Só se a sua organização do Claude tiver os conectores com cabeçalho de pedido ativados (uma funcionalidade beta que a Anthropic ativa por organização) |
| Claude Code | Sim | Sim |
| ChatGPT | Sim | Não |
| Gemini | Sim | Não |
| Cursor | Não | Sim |
| Outros clientes que configure por si (que suportem Streamable HTTP com um cabeçalho personalizado) | Não | Sim |

## Como ligar

**Iniciar sessão com a CloudTalk:**

1. No seu assistente de IA, adicione um conector personalizado com o URL do servidor `https://mcp.cloudtalk.io`. Mantenha a opção de início de sessão (OAuth) que o assistente sugerir.
2. Clique em **Connect**, inicie sessão com a sua conta de administrador da CloudTalk e aprove o acesso.
3. Faça ao seu assistente uma pergunta sobre a sua conta CloudTalk para confirmar que funciona.

**Chave de API:**

1. Crie uma chave de API no Dashboard, em **Definições > Chaves da API**. Consulte [Como aceder e gerar as suas chaves da API da CloudTalk](https://help.cloudtalk.io/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys.md).
2. Adicione o servidor MCP da CloudTalk ao seu assistente de IA, utilizando a sua chave de API.
3. Faça ao seu assistente uma pergunta sobre a sua conta CloudTalk para confirmar que funciona.

O [guia de início rápido do MCP](https://developers.cloudtalk.io/guides/mcp/quickstart) (em inglês) tem a configuração passo a passo para cada assistente.

> [!WARNING]
>
> Só os utilizadores com a função **Admin** podem ligar através do início de sessão. Uma chave de API dá ao assistente acesso a toda a conta da sua empresa: trate-a como uma palavra-passe e elimine-a no Dashboard para cortar o acesso (a alteração pode demorar alguns minutos a produzir efeito). Para terminar uma ligação feita através do início de sessão, desligue o conector no seu assistente.

## Saber mais

O [guia do MCP da CloudTalk para programadores](https://developers.cloudtalk.io/guides/mcp/overview) (em inglês) cobre tudo o resto: perfis de ligação específicos (por exemplo, Analytics ou Voice agents), todas as ferramentas disponíveis, segurança, limites de pedidos e exemplos de prompts prontos a utilizar.

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Estamos aqui para si.


## Related topics

- [Modelos de VoiceAgent: Recepcionista com IA durante o horário de funcionamento](https://help.cloudtalk.io/pt/articles/15645612-voiceagent-templates-during-hours-ai-receptionist.md)
- [Como configurar o Linphone com a CloudTalk](https://help.cloudtalk.io/pt/articles/5373573-how-to-set-up-linphone-with-cloudtalk.md)
- [Modelos de VoiceAgent: Recepcionista com IA fora do horário de funcionamento](https://help.cloudtalk.io/pt/articles/15653481-voiceagent-templates-after-hours-ai-receptionist.md)


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