BoldDesk MCP Server

Visão geral

O BoldDesk MCP Server permite que agentes de IA criem, atualizem e gerenciem tickets de suporte no BoldDesk de forma integrada. Construído sobre o Model Context Protocol (MCP), um padrão aberto para conectar aplicações de IA a ferramentas e serviços externos, ele se integra facilmente a plataformas populares de IA, como Claude, ChatGPT, GitHub Copilot e fluxos de trabalho de agentes autônomos.

O servidor MCP expõe um conjunto estruturado de 31 ferramentas que os agentes de IA podem acessar por meio do padrão MCP, permitindo interações consistentes, confiáveis e previsíveis com o BoldDesk. Qualquer cliente compatível com MCP pode se conectar, autenticar e começar imediatamente a interagir com o BoldDesk para realizar operações reais de suporte.

O BoldDesk MCP Server é totalmente hospedado, o que significa que não há instalação local, pacote ou infraestrutura para manter. Seu cliente MCP se conecta diretamente a um endpoint HTTPS específico da conta.

O que você pode fazer com o BoldDesk MCP?

• Automatize fluxos de trabalho de suporte com ações orientadas por IA: Crie, atualize e direcione tickets a partir de solicitações em linguagem natural.
• Gerencie conversas de tickets de forma conversacional: Envie respostas públicas, notas públicas ou notas internas e consulte o histórico de mensagens.
• Obtenha insights em tempo real e aja diretamente pelo seu assistente de IA: Consulte status de tickets, histórico, registros de trabalho, atividades e aprovações.
• Pesquise e resolva registros do BoldDesk diretamente no seu cliente MCP: Contatos, grupos de contatos, agentes e grupos.

Recursos

• Totalmente gerenciado e hospedado: Sem configuração local, instalação npm ou manutenção contínua; acesso por meio de um endpoint HTTPS simples.
• Autenticação dupla: Token OAuth 2.0 ou cabeçalho x-api-key, com escopo limitado às permissões do usuário autenticado e às marcas associadas.
• Suporte a múltiplos clientes: Funciona com Claude Code, ChatGPT, GitHub Copilot, Code Studio e qualquer cliente compatível com MCP por transporte HTTP remoto.
• Suporte a domínio personalizado: Use o domínio padrão do sistema BoldDesk ou um domínio personalizado mapeado para o endpoint MCP.
• 30 ferramentas em 7 áreas funcionais: Tickets, conversas, atividades, aprovações, registros de trabalho, pesquisa de contatos e metadados de referência.

Como funciona

O MCP Server atua como uma ponte segura entre agentes de IA e as APIs do BoldDesk, permitindo que eles se comuniquem de forma segura e consistente. Com o MCP Server conectado, os agentes de IA podem:

1. Criar, atualizar e gerenciar tickets de suporte.
2. Responder a conversas de tickets.
3. Recuperar detalhes de tickets e histórico de mensagens.
4. Pesquisar contatos, grupos e agentes.
5. Gerenciar fluxos de trabalho de aprovação.
6. Criar e acompanhar atividades (tarefas, chamadas, reuniões).
7. Registrar e recuperar tempo de trabalho faturável/não faturável.

Ferramentas disponíveis

O BoldDesk MCP Server expõe 30 ferramentas, agrupadas em 7 áreas funcionais:

Domínio da ferramenta	O que está acessível
Tickets	Registros completos de tickets (assunto, descrição, status, prioridade, marca, solicitante, responsável, tags, anexos, campos personalizados), formulários/esquemas de campos de tickets e status válidos por marca.
Conversas de tickets	Respostas públicas, notas públicas, notas internas, mensagens do sistema e histórico completo de alterações.
Links de tickets	Links de tickets relacionados, pai e filho, além de links web externos.
Atividades	Tarefas, chamadas e reuniões, com tipo, prioridade, status, responsável, datas, tickets/usuários vinculados e comentários.
Aprovações	Solicitações de aprovação e seu tipo (todos / qualquer um / maioria), aprovadores, status e respostas.
Registros de trabalho	Entradas de tempo em tickets ou atividades, com status de faturamento.
Diretório	Contatos, grupos/empresas de contatos, agentes e grupos de atribuição.
Identidade e referência	Identidade do usuário atual, organização, acesso a marcas e capacidades de formulários; opções de campos para categorias, tipos, fontes, fusos horários e tipos de atividade.

Ver referência detalhada das ferramentas

Tudo isso é limitado pelas permissões do usuário autenticado no BoldDesk e pelo acesso às marcas — um agente de IA só pode ver e agir sobre o que esse usuário poderia ver e agir no próprio BoldDesk.

Conecte-se ao BoldDesk MCP Server

O MCP Server hospedado funciona com interfaces de chat de IA, editores de código e fluxos de trabalho de agentes autônomos. Nenhuma instalação local é necessária. Basta apontar seu cliente para o endpoint e autenticar.

Endpoint:

https://your-subdomain.bolddesk.com/mcp

Substitua your-subdomain pelo subdomínio da sua conta BoldDesk (um domínio personalizado mapeado também funciona). Todas as chamadas de ferramentas são limitadas às permissões do usuário autenticado e às marcas associadas.

Autenticação Use uma das seguintes opções:

• Um token OAuth 2.0

{
  "servers": {
    "bolddeskMcp": {
      "type": "http",
      "url": "https://<your-subdomain>.bolddesk.com/mcp"
    }
  }
}

• Um cabeçalho x-api-key.

{
  "servers": {
    "bolddeskMcp": {
      "type": "http",
      "url": "https://<your-subdomain>.bolddesk.com/mcp",
      "headers": {
        "x-api-key": "your-api-key-here"
      }
    }
  }
}

Configuração por cliente

Cliente	Como conectar
Claude	Adicione o BoldDesk MCP Server como um conector personalizado e autentique via OAuth 2.0.
ChatGPT	Adicione o BoldDesk MCP Server como um plugin, autenticado via OAuth 2.0 ou chave de API.
GitHub Copilot (VS Code)	Configure .vscode/mcp.json, autenticado via OAuth 2.0 ou chave de API.
Code Studio	Adicione o servidor pela interface integrada de MCP Servers usando o tipo de conexão HTTP, autenticado via OAuth 2.0 ou chave de API.
Qualquer outro cliente compatível com MCP	Conecte-se via transporte HTTP remoto com cabeçalhos personalizados, usando um token OAuth 2.0 ou cabeçalho x-api-key.

Totalmente gerenciado e hospedado

O BoldDesk oferece um MCP Server totalmente gerenciado e hospedado — sem configuração local ou manutenção contínua. Comece sem instalação ou infraestrutura, em um serviço hospedado e mantido com segurança, acessível por um endpoint HTTPS simples.