Conectar AI SmartTalk a qualquer cliente MCP
AI SmartTalk expõe um servidor MCP hospedado, para que você possa gerenciar seus assistentes de qualquer ferramenta de IA que fale o Model Context Protocol (MCP) — não apenas Claude. Claude Desktop, Claude na web, Claude Code, ChatGPT, Cursor, VS Code (GitHub Copilot), Cline, Windsurf e qualquer cliente MCP personalizado funcionam da mesma maneira.
Você permanece dentro da ferramenta de IA que já usa e pede, em linguagem simples, para listar assistentes, ler ou reescrever suas instruções, pesquisar e expandir sua base de conhecimento, e diagnosticar a configuração de um cliente. Não há nada para instalar e nenhuma chave de API para copiar — você faz login uma vez com sua conta habitual do AI SmartTalk através de um fluxo OAuth seguro.
Esta é a direção oposta do conector MCP Servers. Lá, seu assistente chama ferramentas externas. Aqui, uma ferramenta de IA externa chama seus assistentes AI SmartTalk.
Como funciona
O cliente MCP se conecta a um único ponto de extremidade seguro, você aprova o acesso com seu login do AI SmartTalk, e a ferramenta de IA pode então chamar as ferramentas do AI SmartTalk em seu nome. Cada ação é restrita à sua conta — você vê e atua apenas sobre os assistentes que já está autorizado a gerenciar em seu painel.
O único ponto de extremidade
Cada cliente MCP se conecta ao mesmo endereço:
https://aismarttalk.tech/api/mcp
- Transporte: HTTP transmitível (JSON-RPC 2.0)
- Autenticação: OAuth 2.0 — você faz login com sua conta do AI SmartTalk; sem chaves de API para gerenciar
- Segurança: Apenas HTTPS; acesso limitado aos assistentes que sua conta gerencia; revogável a qualquer momento
O que você pode fazer
Uma vez conectado, sua ferramenta de IA pode usar essas capacidades do AI SmartTalk automaticamente, escolhendo a certa a partir do que você pede:
| Ação | O que faz |
|---|---|
| Listar assistentes | Lista todos os assistentes que sua conta pode gerenciar |
| Encontrar assistentes | Localiza um assistente pelo nome, pelo e-mail de um usuário ou pela organização |
| Ler instruções | Lê a biografia de um assistente — sua personalidade e regras de decisão |
| Atualizar instruções | Reescreve as instruções e a lógica de roteamento de um assistente |
| Pesquisar conhecimento | Executa uma pesquisa em linguagem natural na base de conhecimento de um assistente |
| Navegar pelo conhecimento | Explora a base de conhecimento interativamente em um visualizador embutido |
| Adicionar um documento | Insere um novo documento de conhecimento, indexado automaticamente |
| Adicionar entradas de FAQ | Adiciona um ou vários pares de pergunta/resposta de uma vez |
| Executar diagnósticos | Inspeciona o plano de um assistente, modelo de IA, tamanho do conhecimento e canais conectados |
| Listar canais e integrações | Veja quais canais e conectores um assistente está conectado |
| Renomear um assistente | Altera o nome exibido de um assistente |
Ele também fornece prompts prontos para uso que seu cliente pode exibir diretamente — por exemplo "melhorar a biografia deste assistente" e "auditar a cobertura de conhecimento para um tópico".
Você pode sempre se referir a um assistente pelo seu nome — não há necessidade de procurar um ID.
Casos de uso
Equipes de suporte — conserte o assistente de um cliente sem sair da sua ferramenta de IA
"Um cliente com o e-mail [email protected] relatou que seu bot dá respostas erradas sobre reembolsos. Encontre seu assistente, verifique como está configurado e pesquise sua base de conhecimento sobre a política de reembolso."
A ferramenta de IA encontra o assistente pelo e-mail, executa diagnósticos (plano, modelo, canais, tamanho do conhecimento) e apresenta o conhecimento relevante — para que você possa triagem um ticket em segundos.
Agências — gerencie muitos assistentes de clientes de um só lugar
"Liste todos os assistentes na organização Acme e me diga quais têm menos de 10 documentos de conhecimento."
Perfeito quando você gerencia dezenas de assistentes entre clientes: enumere-os, identifique aqueles que precisam de atenção e aja — tudo a partir do Claude ou Cursor.
Operações de conteúdo e conhecimento — mantenha a base de conhecimento atualizada
"Adicione uma FAQ ao meu assistente de Suporte: 'Quanto tempo levam os reembolsos?' — 'Os reembolsos chegam em até 5 dias úteis.'" "Audite a cobertura de conhecimento do meu assistente de Vendas para 'preços empresariais' e me diga o que está faltando."
Expanda e audite a base de conhecimento de forma conversacional, e deixe a ferramenta de IA redigir os documentos ou entradas de FAQ para você antes de indexá-los.
Engenharia de prompts — refine instruções em um loop
"Leia as instruções do meu assistente de Suporte e, em seguida, reescreva-as para responder de forma amigável e concisa, e sempre escalar questões de faturamento para um humano."
Itere sobre a personalidade e as regras de roteamento de um assistente com a ferramenta de IA fazendo o trabalho pesado, e veja as mudanças aparecerem instantaneamente em seu painel do AI SmartTalk.
Desenvolvedores — script de gerenciamento de assistentes a partir do seu IDE
A partir do Cursor ou VS Code: "Bootstrap um novo conjunto de FAQ para o assistente de Onboarding a partir deste README."
Gerencie assistentes ao lado do seu código, sem precisar mudar para o painel ou conectar a API REST.
Antes de começar
- Uma conta ativa do AI SmartTalk
- Uma ferramenta de IA que suporte conectores MCP (veja a lista abaixo)
Sem chave de API, sem configuração técnica — você faz login com sua conta habitual do AI SmartTalk.
Conecte sua ferramenta de IA
Claude (Desktop ou web)
-
Abra as Configurações do Claude → Conectores.
-
Escolha Adicionar conector personalizado.
-
Insira o endereço do AI SmartTalk MCP:
https://aismarttalk.tech/api/mcp -
Confirme. Claude abrirá uma página de login do AI SmartTalk.
-
Faça login e aprove o acesso. Claude agora está conectado aos seus assistentes.
Código do Claude
No seu terminal:
claude mcp add --transport http aismarttalk https://aismarttalk.tech/api/mcp
Em seguida, inicie o Código do Claude, execute /mcp e siga o link de login no seu navegador para aprovar o acesso.
Cursor
-
Abra Configurações do Cursor → MCP → Adicionar novo servidor MCP.
-
Adicione o servidor AI SmartTalk:
{
"mcpServers": {
"aismarttalk": {
"url": "https://aismarttalk.tech/api/mcp"
}
}
} -
O Cursor abrirá a página de login do AI SmartTalk — aprove o acesso.
VS Code (GitHub Copilot)
-
Execute MCP: Adicionar Servidor a partir da Paleta de Comandos, ou adicione o servidor ao seu
.vscode/mcp.json:{
"servers": {
"aismarttalk": {
"type": "http",
"url": "https://aismarttalk.tech/api/mcp"
}
}
} -
Inicie o servidor a partir da visualização MCP e complete o login no seu navegador.
Cline, Windsurf e outros clientes
Qualquer cliente que suporte um servidor MCP remoto (HTTP) com OAuth funciona da mesma forma. Adicione um servidor com:
- Nome:
aismarttalk - Transporte / tipo:
http(HTTP transmitível) - URL:
https://aismarttalk.tech/api/mcp
Quando o cliente chamar o servidor pela primeira vez, ele abrirá a página de login do AI SmartTalk para que você possa aprovar o acesso.
Cliente MCP personalizado / seu próprio cliente MCP
O servidor implementa o transporte padrão MCP HTTP transmitível e atua como um servidor de recursos OAuth 2.0. Aponte seu cliente para https://aismarttalk.tech/api/mcp; uma solicitação não autenticada retornará 401 com um cabeçalho WWW-Authenticate apontando para nossos metadados de recurso protegido, para que um cliente MCP compatível possa executar o fluxo OAuth automaticamente.
Experimente
Pergunte à sua ferramenta de IA coisas como:
- "Liste meus assistentes do AI SmartTalk."
- "Mostre-me as instruções para meu assistente de suporte."
- "Atualize meu assistente para que ele sempre responda de forma amigável e concisa."
- "Pesquise na base de conhecimento do meu assistente de Suporte a política de reembolso."
- "Adicione uma FAQ ao meu assistente de Suporte: 'Quanto tempo os reembolsos levam?' — 'Os reembolsos chegam em até 5 dias úteis.'"
- "Um cliente com o e-mail [email protected] tem um problema — encontre seu assistente e me diga como está configurado."
Segurança
- O acesso é concedido através do seu próprio login seguro do AI SmartTalk via OAuth — não há chaves para copiar ou armazenar.
- A conexão só alcança os assistentes que sua conta já gerencia.
- O endpoint funciona apenas sobre HTTPS.
- Você pode revogar o acesso a qualquer momento nas configurações de conectores da sua ferramenta de IA.
FAQ
Isso funciona apenas com o Claude? Não. Qualquer ferramenta de IA com um cliente MCP funciona — Claude, ChatGPT, Cursor, VS Code (Copilot), Cline, Windsurf e clientes personalizados. Claude é apenas o exemplo mais comum.
Preciso de uma chave de API? Não. Você se autentica com sua conta normal do AI SmartTalk através do OAuth. Não há chaves para gerenciar.
Quais assistentes a ferramenta de IA pode ver? Apenas aqueles que sua conta já está autorizada a gerenciar — exatamente como no seu painel do AI SmartTalk.
As alterações são ao vivo? Sim. As edições que você faz através da sua ferramenta de IA — como atualizar instruções ou adicionar conhecimento — aparecem no seu painel do AI SmartTalk imediatamente, e as mudanças no painel também são visíveis para a ferramenta de IA.
Qual é a diferença com o conector de Servidores MCP? O conector Servidores MCP permite que seu assistente chame ferramentas externas. Esta página é o inverso: uma ferramenta de IA externa chama seus assistentes do AI SmartTalk.
Bom saber
- A conexão funciona apenas em um endereço seguro (HTTPS).
- As alterações que você faz através da sua ferramenta de IA aparecem no seu painel do AI SmartTalk imediatamente, e o contrário também.
- Você pode conectar a mesma conta do AI SmartTalk de várias ferramentas de IA ao mesmo tempo.