Tidio
oficialConecte o Tidio ao seu site via MCP. Incorpore o widget sem sair do seu ambiente de programação.
O que você pode fazer com Tidio MCP?
- Conectar Tidio a um site — Peça para conectar Tidio a uma URL de site via
tidio_connect, que abre um navegador para login OAuth e recupera automaticamente sua chave pública. - Verificar status da conexão — Use para verificar se o Tidio está conectado e recuperar seu código de incorporação atual.
- Gerar código de incorporação — Chame com uma chave pública para produzir JavaScript pronto para uso, opcionalmente escolhendo carregamento
asyncousync. - Desconectar Tidio — Execute para limpar credenciais armazenadas localmente em
~/.tidio-mcp/credentials.json.
Documentação
Conector MCP Tidio
Um servidor MCP (Model Context Protocol) que conecta assistentes de IA ao Tidio chat ao vivo - com configuração automática
Recursos
- Configuração Automática: Conecte-se ao Tidio com um comando - sem copiar chaves manualmente
- Autenticação OAuth: Abre o navegador para login seguro no Tidio, recupera automaticamente sua chave pública
- Persistência de Credenciais: As credenciais são salvas localmente para sessões futuras
- Geração de Código de Incorporação: Obtenha código JavaScript pronto para uso em qualquer site
Instalação
npm install tidio-mcp-connector
Ou clone e construa localmente:
git clone https://github.com/your-username/tidio-mcp-connector.git
cd tidio-mcp-connector
npm install
npm run build
Uso
Com Claude Desktop
Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"tidio": {
"command": "npx",
"args": ["tidio-mcp-connector"]
}
}
}
Com Lovable
Este conector MCP funciona com Lovable e plataformas de desenvolvimento similares com IA. Adicione-o como um servidor MCP personalizado.
Com MCP Inspector (Teste)
npx @modelcontextprotocol/inspector npx tidio-mcp-connector
Ferramentas Disponíveis
tidio_connect (Recomendado)
Conecte-se ao Tidio e obtenha automaticamente sua chave pública.
Como funciona:
- Abre seu navegador na página de login do Tidio
- Você autentica com sua conta Tidio
- Retorna sua chave pública e código de incorporação automaticamente
Parâmetros:
site_url(obrigatório): A URL do site onde o Tidio será incorporado
Exemplo:
Connect Tidio to https://mywebsite.com
tidio_status
Verifique o status da sua conexão e obtenha seu código de incorporação.
Parâmetros: Nenhum
tidio_disconnect
Limpe as credenciais armazenadas.
Parâmetros: Nenhum
generate_tidio_embed
Gere código de incorporação para uma chave pública específica (se você já tiver uma).
Parâmetros:
public_key(obrigatório): Sua chave pública do Tidioloading_mode(opcional):"async"(padrão) ou"sync"
Como Funciona
- O usuário chama
tidio_connectcom a URL do seu site - O navegador abre a página de autenticação do Tidio
- O usuário faz login na sua conta Tidio
- Callback recebido - o servidor MCP obtém o refresh token
- Chamadas de API feitas - troca o token por um token de acesso e depois recupera a chave pública
- Credenciais salvas em
~/.tidio-mcp/credentials.json - Código de incorporação retornado - pronto para adicionar ao site
Armazenamento de Credenciais
As credenciais são armazenadas localmente em ~/.tidio-mcp/credentials.json:
{
"public_key": "abc123...",
"access_token": "...",
"refresh_token": "...",
"site_url": "https://example.com",
"created_at": "2024-01-01T00:00:00.000Z",
"updated_at": "2024-01-01T00:00:00.000Z"
}
Saída do Código de Incorporação
O conector gera código de carregamento assíncrono otimizado:
<script type="text/javascript">
document.tidioChatCode = "YOUR_PUBLIC_KEY";
(function() {
function asyncLoad() {
var tidioScript = document.createElement("script");
tidioScript.type = "text/javascript";
tidioScript.async = true;
tidioScript.src = "//code.tidio.co/YOUR_PUBLIC_KEY.js";
document.body.appendChild(tidioScript);
}
if (window.attachEvent) {
window.attachEvent("onload", asyncLoad);
} else {
window.addEventListener("load", asyncLoad, false);
}
})();
</script>
Desenvolvimento
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run built version
npm start