Conecte o Hedy com Assistentes de IA Usando MCP

O Que é o Servidor MCP do Hedy?

O servidor MCP do Hedy permite que assistentes de IA acessem e ajudem a organizar seus dados do Hedy de forma segura. Uma vez conectado, você pode pedir à sua IA para analisar transcrições de reuniões, encontrar destaques, revisar itens de ação, criar tópicos e gerenciar seus contextos de sessão — tudo através de conversa natural.

MCP (Model Context Protocol) é um padrão aberto que permite que aplicações de IA se conectem a fontes de dados externas. O servidor MCP do Hedy usa autenticação OAuth, tornando-o compatível com plataformas de IA baseadas na web, aplicações desktop e ferramentas de desenvolvimento.

URLs do Servidor por Região

O servidor MCP do Hedy é executado em duas regiões para manter os dados dos usuários na jurisdição correta. Use a URL que corresponde à região em que sua conta foi criada:

• Contas dos EUA: https://api.hedy.bot/mcp

• Contas da UE: https://eu-api.hedy.bot/mcp

Ambos os servidores executam código idêntico, então as ferramentas disponíveis e o comportamento são os mesmos. Os dados de sessão e conversa de usuários da UE permanecem dentro da UE. Se não tiver certeza de qual região sua conta usa, abra o Hedy e vá para Configurações da Conta → Preferências de Privacidade — o ícone de bandeira mostra o local de armazenamento dos seus dados.

Os exemplos de configuração abaixo usam https://api.hedy.bot/mcp. Se sua conta estiver na UE, substitua por https://eu-api.hedy.bot/mcp em todos os lugares — incluindo a descoberta OAuth e as URLs /.well-known/....

Como Conectar

Passo 1: Adicionar o Servidor

1. Abra as configurações do servidor MCP do seu cliente de IA

2. Procure por “Add MCP Server”, “Connect Remote Server” ou “Add Integration”

3. Insira a URL do servidor: https://api.hedy.bot/mcp

4. Clique em “Add” ou “Connect”

Passo 2: Autorizar o Acesso

1. Seu cliente de IA abrirá uma janela do navegador

2. Faça login com sua conta Hedy

3. Revise as permissões solicitadas

4. Clique em “Allow” para autorizar

5. Retorne ao seu cliente de IA

Pronto! Não é necessário configurar arquivos ou chaves de API.

Clientes de IA Compatíveis

Funciona com qualquer cliente compatível com MCP que suporte servidores remotos:

• Plataformas de IA baseadas na web - Assistentes de IA acessíveis pelo navegador

• Aplicações desktop - Claude Desktop, BoltAI, Cursor, Windsurf, Zed

• Ferramentas de desenvolvimento - VS Code com GitHub Copilot, Cline, Claude Code

• Plataformas de agentes de IA - Construtores de fluxos de trabalho personalizados

Instruções de Configuração por Cliente

Claude Code (CLI)

Adicione o servidor MCP do Hedy com um único comando:

claude mcp add --transport http hedy https://api.hedy.bot/mcp

Isso acionará o fluxo OAuth no seu navegador. Faça login com sua conta Hedy e autorize o acesso.

Claude Desktop (todos os planos)

1. Abra o Claude Desktop e vá para Settings

2. Abra Connectors (versões mais antigas podem chamar isso de Integrations)

3. Clique em + e depois em Add custom connector

4. Insira:

   • Name: Hedy

   • Remote MCP server URL: https://api.hedy.bot/mcp

5. Clique em Add (ou Connect) e complete o fluxo OAuth no seu navegador

6. Em novos chats, clique no ícone de ferramentas para ativar as ferramentas do Hedy

Nota: Usuários do Claude Free podem adicionar o Hedy como seu único conector personalizado permitido seguindo os passos acima. Se você já usou sua única vaga do plano Free para outro serviço, ou quer executar vários servidores MCP remotos, a ponte mcp-remote (descrita na seção do BoltAI abaixo) também funciona com o Claude Desktop.

Cline (Extensão VS Code)

Opção 1: Via Interface do Cline (Recomendado)

1. Abra o VS Code com a extensão Cline instalada

2. Clique no ícone do Cline na barra lateral

3. Clique no menu (⋮) e selecione “MCP Servers”

4. Selecione a aba “Remote Servers”

5. Insira: Server Name: hedy, Server URL: https://api.hedy.bot/mcp, Transport Type: Streamable HTTP

6. Clique em “Add Server”

7. Clique em “Authenticate” quando solicitado e complete o fluxo OAuth no seu navegador

Opção 2: Configuração Manual via JSON

1. Abra o arquivo de configurações MCP do Cline:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Adicione esta configuração:

   {"mcpServers": {"hedy": {"url": "https://api.hedy.bot/mcp","type": "streamableHttp","disabled": false}}}

3. Salve o arquivo e reinicie o VS Code

4. O fluxo OAuth será acionado quando o Cline tentar usar o servidor

BoltAI (macOS)

O BoltAI se conecta a servidores MCP via configuração local. Como o BoltAI não suporta nativamente servidores remotos OAuth, você precisará da ponte mcp-remote.

Requisitos: Node.js deve estar instalado no seu Mac (execute node -v para verificar).

1. Abra BoltAI → Settings → Plugins, clique no botão + para abrir mcp.json

2. Adicione a seguinte configuração:

   {"mcpServers":{"hedy":{"command":"npx","args":["mcp-remote","https://api.hedy.bot/mcp"]}}}

3. Clique em Save Changes

4. No primeiro uso, uma janela do navegador será aberta — faça login com sua conta Hedy e autorize o acesso

Nota: A ponte mcp-remote traduz o servidor remoto habilitado para OAuth em uma conexão stdio local que o BoltAI pode utilizar. Após a primeira autorização, o token é armazenado localmente em cache.

Cursor / Windsurf / Outras Ferramentas de IDE

1. Abra as configurações MCP na sua IDE

2. Adicione a URL do servidor: https://api.hedy.bot/mcp

3. Selecione “HTTP” ou “Streamable HTTP” como tipo de transporte

4. Autorize quando solicitado

Clientes de IA Baseados na Web

1. Encontre “Connect MCP Server” ou “Add Integration”

2. Insira: https://api.hedy.bot/mcp

3. Complete a autorização OAuth no seu navegador

Ferramentas Disponíveis

O servidor MCP do Hedy fornece 18 ferramentas que seu assistente de IA pode usar para acessar e organizar seus dados de reuniões:

Ferramentas de Sessão

GetSessions

O que faz: Lista suas sessões de reuniões recentes, ordenadas por hora de início (mais recente primeiro)

Parâmetros:

• limit (opcional) - Número de sessões a retornar (1-100)

• after (opcional) - ID da sessão para iniciar a paginação a partir dele

Exemplos de solicitações:

• “Mostre minhas últimas 10 sessões”

• “Liste todas as sessões desta semana”

• “Quais reuniões tive recentemente?”

GetSessionDetails

O que faz: Recupera os detalhes completos de uma sessão específica, incluindo metadados, participantes e transcrição

Parâmetros:

• sessionId (obrigatório) - O ID da sessão

Exemplos de solicitações:

• “Mostre os detalhes da sessão ABC123”

• “O que foi discutido na minha última reunião de equipe?”

• “Obtenha a transcrição da sessão de lançamento do produto”

GetSessionHighlights

O que faz: Retorna todos os destaques capturados durante uma sessão específica

Parâmetros:

• sessionId (obrigatório) - O ID da sessão

Exemplos de solicitações:

• “Quais destaques salvei na sessão ABC123?”

• “Mostre os momentos-chave da reunião diária de ontem”

• “Liste todos os destaques da reunião de orçamento”

GetSessionToDos

O que faz: Lista todos os itens de tarefas gerados durante uma sessão específica

Parâmetros:

• sessionId (obrigatório) - O ID da sessão

• includeCompleted (opcional) - Se verdadeiro, inclui tarefas concluídas (padrão: apenas tarefas em aberto)

Exemplos de solicitações:

• “Quais itens de ação surgiram da sessão ABC123?”

• “Mostre as tarefas da reunião com o cliente, incluindo as concluídas”

• “Liste as tarefas pendentes da sessão de planejamento de ontem”

Ferramentas de Destaques

GetHighlights

O que faz: Lista seus destaques recentes de todas as sessões, ordenados do mais recente primeiro

Parâmetros:

• limit (opcional) - Número de destaques a retornar (1-100)

• after (opcional) - ID do destaque para iniciar a paginação a partir dele

Exemplos de solicitações:

• “Mostre meus últimos 20 destaques”

• “O que destaquei esta semana?”

• “Liste os momentos-chave recentes que salvei”

GetHighlightDetails

O que faz: Recupera os detalhes completos de um destaque específico, incluindo trecho da transcrição, carimbo de data/hora e contexto

Parâmetros:

• highlightId (obrigatório) - O ID do destaque

Exemplos de solicitações:

• “Mostre o destaque XYZ789 em detalhes”

• “Qual era o contexto daquele destaque sobre o orçamento?”

• “Obtenha a transcrição completa do destaque XYZ789”

Ferramentas de Tarefas

GetToDos

O que faz: Retorna todos os itens de tarefas de todas as suas sessões

Parâmetros:

• includeCompleted (opcional) - Se verdadeiro, inclui tarefas concluídas (padrão: apenas tarefas em aberto)

Exemplos de solicitações:

• “Quais são todos os meus itens de ação pendentes?”

• “Mostre todas as tarefas, incluindo as concluídas”

• “Liste tudo que preciso fazer a partir das minhas reuniões”

Ferramentas de Tópicos

Os assistentes de IA podem visualizar seus tópicos e também ajudá-lo a organizá-los criando novos tópicos, atualizando existentes ou removendo tópicos desnecessários.

GetAllTopics

O que faz: Lista todos os seus tópicos e pastas de reuniões

Parâmetros:

• includeArchived (opcional) - Se verdadeiro, inclui tópicos arquivados (padrão: apenas tópicos ativos)

Exemplos de solicitações:

• “Quais tópicos tenho no Hedy?”

• “Liste todas as minhas categorias de reuniões”

• “Mostre todos os tópicos, incluindo os arquivados”

GetTopicDetails

O que faz: Recupera detalhes de um tópico específico, incluindo descrição, contagem de sessões e insights gerados por IA

Parâmetros:

• topicId (obrigatório) - O ID do tópico

Exemplos de solicitações:

• “Mostre detalhes do tópico Reuniões com Clientes”

• “Quantas sessões existem no meu tópico Reuniões Diárias?”

• “Que insights o Hedy tem sobre meu tópico Planejamento de Produto?”

GetTopicSessions

O que faz: Lista todas as sessões associadas a um tópico específico

Parâmetros:

• topicId (obrigatório) - O ID do tópico

Exemplos de solicitações:

• “Mostre todas as sessões no tópico Planejamento de Produto”

• “Liste reuniões marcadas com Reuniões com Clientes”

• “Quais sessões estão na minha pasta de 1:1s?”

CreateTopic

O que faz: Cria um novo tópico para organizar suas sessões de reuniões

Parâmetros:

• name (obrigatório) - Nome do tópico (máximo 100 caracteres)

• description (opcional) - Descrição do tópico (máximo 500 caracteres)

• color (opcional) - Cor do tópico (ex.: #FF5733)

• iconName (opcional) - Nome do ícone do tópico

• topicContext (opcional) - Instruções personalizadas para análise de IA das sessões neste tópico

Exemplos de solicitações:

• “Crie um novo tópico chamado Planejamento Q1”

• “Faça um tópico para ligações com clientes com cor azul”

• “Configure uma nova categoria para sessões de entrevista”

UpdateTopic

O que faz: Atualiza o nome, descrição, cor ou outras configurações de um tópico existente

Parâmetros:

• topicId (obrigatório) - O ID do tópico a atualizar

• name (opcional) - Novo nome do tópico

• description (opcional) - Nova descrição

• color (opcional) - Nova cor

• iconName (opcional) - Novo ícone

• topicContext (opcional) - Novas instruções personalizadas para análise de IA

Exemplos de solicitações:

• “Renomeie o tópico Planejamento Q1 para Planejamento Q2”

• “Mude a cor do meu tópico Reuniões com Clientes para verde”

• “Atualize a descrição do meu tópico Reuniões Diárias”

DeleteTopic

O que faz: Remove um tópico. As sessões anteriormente nesse tópico são preservadas, mas não ficam mais agrupadas nele.

Parâmetros:

• topicId (obrigatório) - O ID do tópico a remover

Exemplos de solicitações:

• “Exclua o tópico antigo Projeto Alpha”

• “Remova meu tópico Preparação para Entrevistas que não uso mais”

• “Apague o tópico chamado Teste”

Ferramentas de Contexto de Sessão

Os contextos de sessão permitem que você forneça informações de fundo que o Hedy usa ao analisar suas reuniões. Os assistentes de IA podem ajudá-lo a visualizar e gerenciar esses contextos.

ListSessionContexts

O que faz: Lista todos os seus contextos de sessão salvos, ordenados pelo mais recentemente atualizado

Exemplos de solicitações:

• “Mostre todos os meus contextos de sessão”

• “Quais contextos de fundo tenho configurados?”

• “Liste meus perfis de contexto de reunião”

GetSessionContext

O que faz: Recupera os detalhes de um contexto de sessão específico

Parâmetros:

• contextId (obrigatório) - O ID do contexto a recuperar

Exemplos de solicitações:

• “Mostre os detalhes do meu contexto de Trabalho”

• “O que há no meu contexto de sessão padrão?”

CreateSessionContext

O que faz: Cria um novo contexto de sessão com informações de fundo para o Hedy usar durante a análise

Parâmetros:

• title (obrigatório) - Título do contexto (máximo 200 caracteres)

• content (opcional) - As informações de fundo e instruções

• isDefault (opcional) - Definir como seu contexto padrão

Exemplos de solicitações:

• “Crie um novo contexto chamado Ligações de Vendas com informações sobre meus produtos”

• “Configure um contexto para minhas reuniões da equipe de engenharia”

• “Crie um novo contexto padrão com meu cargo e responsabilidades”

UpdateSessionContext

O que faz: Atualiza um contexto de sessão existente

Parâmetros:

• contextId (obrigatório) - O ID do contexto a atualizar

• title (opcional) - Novo título

• content (opcional) - Novas informações de fundo

• isDefault (opcional) - Definir como contexto padrão

Exemplos de solicitações:

• “Atualize meu contexto de Trabalho com minha nova estrutura de equipe”

• “Adicione informações sobre nossos objetivos do Q2 ao meu contexto padrão”

• “Mude meu contexto de Vendas para ser o padrão”

DeleteSessionContext

O que faz: Remove um contexto de sessão. Se você excluir seu contexto padrão, outro se tornará automaticamente o padrão.

Parâmetros:

• contextId (obrigatório) - O ID do contexto a remover

Exemplos de solicitações:

• “Exclua meu contexto antigo do Projeto X”

• “Remova o contexto que não estou mais usando”

Exemplos de Fluxos de Trabalho

Revisão Semanal

Peça à sua IA: “Mostre minhas sessões desta semana, liste todas as tarefas pendentes e destaque itens importantes”

O que acontece: A IA usa GetSessions com filtro de data, depois GetToDos para encontrar itens de ação, e pode entrar em sessões específicas para detalhes.

Preparação para Reuniões

Peça à sua IA: “Encontre todas as sessões sobre o roadmap do Q4 e resuma os pontos-chave”

O que acontece: A IA pesquisa nas sessões, usa GetSessionDetails e GetSessionHighlights para reunir informações, e então cria um resumo.

Gerenciamento de Tarefas

Peça à sua IA: “Mostre todos os itens de ação das reuniões com clientes deste mês”

O que acontece: A IA usa GetAllTopics para encontrar o tópico Reuniões com Clientes, GetTopicSessions para listar as sessões, depois GetSessionToDos de cada uma para compilar a lista.

Análise de Tópicos

Peça à sua IA: “Analise minhas sessões de Reuniões Diárias e identifique temas recorrentes”

O que acontece: A IA encontra o tópico, recupera todas as sessões nele, lê transcrições e destaques, e então realiza a análise.

Organizando Seus Dados

Peça à sua IA: “Crie um novo tópico chamado Planejamento Q2 e configure um contexto para nossas revisões trimestrais”

O que acontece: A IA usa CreateTopic para criar o novo tópico, depois CreateSessionContext para configurar informações de fundo para uma melhor análise de reuniões.

Privacidade e Segurança

• OAuth 2.1 com PKCE - Autenticação segura no padrão da indústria

• Você controla o acesso - Autorize exatamente o que a IA pode fazer com seus dados

• Os dados das sessões são protegidos - A IA pode ajudar a organizar tópicos e contextos, mas não pode excluir suas gravações ou transcrições de reuniões

• Apenas sob demanda - Os dados são acessados apenas quando você faz solicitações

• Revogue a qualquer momento - Você pode desconectar o acesso da IA a qualquer momento nas configurações do Hedy

Requisitos

• Assinatura ativa do Hedy (Pro ou Premium)

• Cloud Sync ativado nas configurações do Hedy

• Um assistente de IA que suporte MCP (como o Claude)

Solução de Problemas

O cliente de IA não tem a opção “Add MCP Server”

• Verifique se seu cliente suporta servidores MCP remotos

• Atualize para a versão mais recente

• Procure as configurações de MCP nas preferências

• Alguns clientes suportam apenas servidores locais e precisam de configuração manual

A autorização falha

• Certifique-se de que você está logado no Hedy

• Verifique se sua conta está ativa

• Limpe o cache do navegador e tente novamente

• Verifique a conexão com a internet

• Tente abrir https://api.hedy.bot/mcp/.well-known/oauth-protected-resource para verificar se o servidor está acessível

A IA não consegue acessar meus dados

• Confirme que a autorização OAuth foi concluída

• Verifique se você tem sessões na sua conta Hedy

• Verifique o status da autorização nas configurações do cliente de IA

• Tente desconectar e reconectar

A conexão parou de funcionar

• O token de acesso pode ter expirado — reautorize

• Se você alterou a senha do Hedy, reautorize

• Verifique status.hedy.bot para problemas no serviço

• Remova e adicione o servidor novamente

O navegador continua pedindo para reautorizar a cada reinicialização do Claude Desktop

• O Hedy emite tokens de atualização de 30 dias, então um cliente funcional deve autorizar uma vez e depois atualizar silenciosamente em segundo plano.

• Se você vê a solicitação OAuth toda vez que inicia o Claude Desktop, isso geralmente indica um problema de cache de tokens no lado do cliente, em vez de um problema no servidor do Hedy:

  • No caminho nativo de Connector do Claude Desktop, a Anthropic tem bugs abertos sobre a persistência de tokens de conectores personalizados. Remover e adicionar o conector novamente às vezes limpa o estado travado. Se isso não resolver, o caminho alternativo abaixo costuma funcionar.

  • Na ponte mcp-remote, encerre completamente o Claude Desktop, execute rm -rf ~/.mcp-auth para limpar credenciais obsoletas, depois fixe a versão mais recente na sua configuração: ["-y", "mcp-remote@latest", "https://api.hedy.bot/mcp"]. Reinicie e autorize uma vez.

  • Para ver exatamente o que o mcp-remote está fazendo durante uma reinicialização, execute-o isoladamente com --debug: npx -y mcp-remote@latest https://api.hedy.bot/mcp --debug. Isso imprime o caminho do cache e quaisquer erros de troca de token. Compartilhe a saída com o suporte se a solicitação continuar recorrendo.

• Não passe um cabeçalho estático Authorization: Bearer ... por meio de --header. O endpoint MCP do Hedy é somente OAuth, e um cabeçalho Bearer estático entra em conflito com o token de acesso que o mcp-remote negocia internamente, gerando 401s.

O cliente requer configuração manual de OAuth

• Se seu cliente não suporta descoberta automática, use estas configurações:

  • Authorization URL: https://api.hedy.bot/mcp/oauth/authorize

  • Token URL: https://api.hedy.bot/mcp/oauth/token

  • Scopes: mcp.sessions.read mcp.highlights.read mcp.todos.read mcp.topics.read mcp.topics.write mcp.contexts.read mcp.contexts.write

A IA diz que uma ferramenta falhou ou retornou um erro

• Verifique se o ID da sessão/destaque/tópico é válido

• Verifique se você tem permissão para acessar esses dados

• Certifique-se de que os dados solicitados existem na sua conta

• Tente ser mais específico (ex.: inclua títulos de sessão em vez de IDs)

• Verifique se há limitação de taxa — aguarde um momento e tente novamente

Melhores Práticas

Para Melhores Resultados

• Use títulos de sessão claros - Facilita a busca pela IA

• Organize com tópicos - Agrupe sessões relacionadas

• Crie destaques durante as reuniões - Ajuda a IA a identificar momentos-chave

• Adicione notas descritivas às tarefas - Torna os itens de ação mais pesquisáveis

• Seja específico nas solicitações - Inclua datas, tópicos ou palavras-chave

Ao Perguntar à Sua IA

• Especifique intervalos de tempo - “Mostre sessões da semana passada” é mais claro do que “Mostre sessões recentes”

• Mencione tópicos quando relevante - “Sessões de reuniões com clientes” vs “todas as sessões”

• Peça resumos - A IA pode sintetizar dados de múltiplas ferramentas

• Solicite formatos específicos - “Crie uma lista com marcadores” ou “Faça uma tabela”

• Faça perguntas de acompanhamento - A IA pode aprofundar nos resultados

Dica profissional: A IA pode combinar múltiplas ferramentas em uma única solicitação. Tente fazer perguntas complexas como “Encontre todas as tarefas pendentes das reuniões com clientes deste mês e organize-as por prioridade” ou “Crie um novo tópico para nossos lançamentos de produto e liste todas as sessões que devem estar nele” para ver o poder da integração MCP.

Precisa de Ajuda?

• Consulte a documentação MCP do seu cliente de IA para instruções específicas do cliente

• Visite modelcontextprotocol.io para informações gerais sobre MCP

• Entre em contato com o suporte do Hedy com mensagens de erro e o nome do seu cliente de IA