Freshdesk

Integra-se com o Freshdesk para gerenciar tickets de suporte, contatos e outras operações de atendimento ao cliente.

Documentação

Servidor MCP Freshdesk

Uma implementação de servidor MCP que se integra ao Freshdesk, permitindo que modelos de IA interajam com os módulos do Freshdesk e realizem diversas operações de suporte.

Recursos

Integração com Freshdesk: Interação perfeita com os endpoints da API do Freshdesk
Suporte a Modelos de IA: Permite que modelos de IA realizem operações de suporte por meio do Freshdesk
Gerenciamento Automatizado de Tickets: Lida com criação, atualização e respostas de tickets

Componentes

Ferramentas

O servidor oferece várias ferramentas para operações no Freshdesk:

create_ticket: Criar novos tickets de suporte
- Entradas:
  - subject (string, obrigatório): Assunto do ticket
  - description (string, obrigatório): Descrição do ticket
  - source (número, obrigatório): Código da fonte do ticket
  - priority (número, obrigatório): Nível de prioridade do ticket
  - status (número, obrigatório): Código de status do ticket
  - email (string, opcional): E-mail do solicitante
  - requester_id (número, opcional): ID do solicitante
  - custom_fields (objeto, opcional): Campos personalizados a serem definidos no ticket
  - additional_fields (objeto, opcional): Campos adicionais de nível superior
update_ticket: Atualizar tickets existentes
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket a ser atualizado
  - ticket_fields (objeto, obrigatório): Campos a serem atualizados
delete_ticket: Excluir um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket a ser excluído
search_tickets: Pesquisar tickets com base em critérios
- Entradas:
  - query (string, obrigatório): String de consulta de pesquisa
get_ticket_fields: Obter todos os campos de ticket
- Entradas:
  - Nenhuma
get_tickets: Obter todos os tickets
- Entradas:
  - page (número, opcional): Número da página a ser buscada
  - per_page (número, opcional): Número de tickets por página
get_ticket: Obter um único ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket a ser obtido
get_ticket_conversation: Obter conversa de um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
create_ticket_reply: Responder a um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
  - body (string, obrigatório): Conteúdo da resposta
  - cc_emails (matriz de strings, opcional): Endereços de e-mail adicionais adicionados ao campo 'cc' do e-mail de saída. Eles complementam o solicitante do ticket, que sempre permanece como destinatário principal
  - bcc_emails (matriz de strings, opcional): Endereços de e-mail adicionais adicionados ao campo 'bcc' do e-mail de saída. Eles complementam o solicitante do ticket, que sempre permanece como destinatário principal
  - from_email (string, opcional): Endereço de e-mail do qual a resposta é enviada
  - user_id (número, opcional): ID do agente que está adicionando a resposta
create_ticket_note: Adicionar uma nota a um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
  - body (string, obrigatório): Conteúdo da nota
update_ticket_conversation: Atualizar uma conversa
- Entradas:
  - conversation_id (número, obrigatório): ID da conversa
  - body (string, obrigatório): Conteúdo atualizado
view_ticket_summary: Obter o resumo de um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
update_ticket_summary: Atualizar o resumo de um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
  - body (string, obrigatório): Novo conteúdo do resumo
delete_ticket_summary: Excluir o resumo de um ticket
- Entradas:
  - ticket_id (número, obrigatório): ID do ticket
get_agents: Obter todos os agentes
- Entradas:
  - page (número, opcional): Número da página
  - per_page (número, opcional): Número de agentes por página
view_agent: Obter um único agente
- Entradas:
  - agent_id (número, obrigatório): ID do agente
create_agent: Criar um novo agente
- Entradas:
  - agent_fields (objeto, obrigatório): Detalhes do agente
update_agent: Atualizar um agente
- Entradas:
  - agent_id (número, obrigatório): ID do agente
  - agent_fields (objeto, obrigatório): Campos a serem atualizados
search_agents: Pesquisar agentes
- Entradas:
  - query (string, obrigatório): Consulta de pesquisa
list_contacts: Obter todos os contatos
- Entradas:
  - page (número, opcional): Número da página
  - per_page (número, opcional): Contatos por página
get_contact: Obter um único contato
- Entradas:
  - contact_id (número, obrigatório): ID do contato
search_contacts: Pesquisar contatos
- Entradas:
  - query (string, obrigatório): Consulta de pesquisa
update_contact: Atualizar um contato
- Entradas:
  - contact_id (número, obrigatório): ID do contato
  - contact_fields (objeto, obrigatório): Campos a serem atualizados
list_companies: Obter todas as empresas
- Entradas:
  - page (número, opcional): Número da página
  - per_page (número, opcional): Empresas por página
view_company: Obter uma única empresa
- Entradas:
  - company_id (número, obrigatório): ID da empresa
search_companies: Pesquisar empresas
- Entradas:
  - query (string, obrigatório): Consulta de pesquisa
find_company_by_name: Encontrar uma empresa pelo nome
- Entradas:
  - name (string, obrigatório): Nome da empresa
list_company_fields: Obter todos os campos de empresa
- Entradas:
  - Nenhuma

Primeiros Passos

Instalação via Smithery

Para instalar o freshdesk_mcp para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

Pré-requisitos

Uma conta Freshdesk (cadastre-se em freshdesk.com)
Chave de API do Freshdesk
uvx instalado (pip install uv ou brew install uv)

Configuração

Gere sua chave de API do Freshdesk no painel administrativo do Freshdesk
Configure seu domínio e detalhes de autenticação

Uso com Claude Desktop

Instale o Claude Desktop se ainda não o fez
Adicione a seguinte configuração ao seu claude_desktop_config.json:

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

Notas Importantes:

Substitua YOUR_FRESHDESK_API_KEY pela sua chave de API real do Freshdesk
Substitua YOUR_FRESHDESK_DOMAIN pelo seu domínio do Freshdesk (por exemplo, yourcompany.freshdesk.com)

Exemplos de Operações

Após a configuração, você pode pedir ao Claude para realizar operações como:

"Criar um novo ticket com assunto 'Problema de Pagamento para o cliente A101' e descrição 'Entrando em contato sobre um problema de pagamento no último mês para o cliente A101', onde o e-mail do cliente é a101@acme.com e definir prioridade como alta"
"Atualizar o status do ticket #12345 para 'Resolvido'"
"Listar todos os tickets de alta prioridade atribuídos ao agente João Silva"
"Listar tickets anteriores do cliente A101 nos últimos 30 dias"

Testes

Para fins de teste, você pode iniciar o servidor manualmente:

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

Solução de Problemas

Verifique se sua chave de API e domínio do Freshdesk estão corretos
Garanta conectividade de rede adequada aos servidores do Freshdesk
Verifique os limites de taxa e cotas da API
Verifique se o comando uvx está disponível no seu PATH

Licença

Este servidor MCP é licenciado sob a Licença MIT. Consulte o arquivo LICENSE no repositório do projeto para obter detalhes completos.