Kudosity MCP

O servidor Kudosity Model Context Protocol (MCP) permite que editores com tecnologia de IA (como Cursor e Windsurf) e assistentes (como Claude Desktop) explorem e executem diretamente as APIs da Kudosity. Com o MCP, sua IA pode pesquisar especificações de API, gerar trechos de código e executar requisições ao vivo — tudo sem sair do seu ambiente de desenvolvimento.

O que é MCP?

Model Context Protocol (MCP) é um padrão aberto que permite que aplicações de IA acessem com segurança fontes de dados e ferramentas externas. O servidor Kudosity MCP fornece aos agentes de IA:

• Acesso direto à API das funcionalidades da Kudosity — enviar mensagens, atualizar listas de contatos, etc.
• Pesquisa de documentação — faça sua IA pesquisar de forma inteligente as especificações da API e tutoriais para fornecer respostas precisas.
• Dados em tempo real da sua conta Kudosity — consulte e execute operações ao vivo diretamente do chat.
• Geração de código para integrações com a Kudosity
• Execução de API ao vivo — além de exemplos estáticos, execute requisições reais
• Sempre atualizado — alimentado pelas definições de origem da API Swagger

Capacidades do Servidor MCP

O servidor Kudosity MCP oferece ferramentas abrangentes para descoberta de API, documentação, geração de código e execução ao vivo:

🔍 Descoberta e Exploração de API

• list-specs — descubra APIs de mensageria disponíveis (SMS, RCS, WhatsApp, etc.)
• list-endpoints — liste todos os caminhos e métodos de API para um serviço
• get-endpoint — inspecione métodos e parâmetros suportados para qualquer caminho
• search-specs — pesquise nas especificações por palavras-chave ou padrões

📋 Esquema e Documentação da API

• get-request-body — recupere o esquema do corpo da requisição para qualquer endpoint
• get-response-schema — visualize o esquema de resposta para endpoints e códigos de status específicos
• list-security-schemes — verifique métodos de autenticação e requisitos
• search-documentation — pesquise conteúdo da documentação da API

⚡ Geração de Código

• get-code-snippet — gere exemplos prontos para executar em curl, JavaScript, Python, etc.
• Fornece autenticação e parâmetros adequados automaticamente

🚀 Execução de API ao Vivo

• execute-request — execute chamadas de API reais usando o formato HAR
• Envie mensagens SMS de teste
• Valide qualquer endpoint da Kudosity com credenciais ao vivo
• Retorna respostas e erros reais

APIs Disponíveis

O servidor MCP fornece acesso a estas APIs da Kudosity:

• Transmit Message API — serviço de mensageria v2 com suporte a SMS, RCS, MMS, WhatsApp e webhooks
• Transmit SMS API — SMS completo com listas de contatos avançadas, palavras-chave e relatórios

Configuração do Servidor Kudosity MCP

A Kudosity hospeda um servidor MCP remoto em https://developers.kudosity.com/mcp. Configure suas ferramentas de desenvolvimento de IA para se conectar a este servidor.

Configuração de Autenticação

Para APIs que exigem autenticação, você precisará configurar suas credenciais de API. Dependendo dos endpoints, os métodos diferem:

• api.transmitsms.com (endpoints v1) — Autenticação Basic com API Key e Secret codificados em Base64
• api.transmitmessage.com (endpoints v2) — Autenticação por API Key com sua chave no cabeçalho x-api-key

Para endpoints v1 (api.transmitsms.com) - Autenticação Basic:

1. Obtenha suas credenciais no painel Kudosity → Developers → API Settings
2. Combine como: API_KEY:API_SECRET
3. Codifique em Base64:
   • Terminal: echo -n "API_KEY:API_SECRET" | base64
   • Console do navegador: btoa("API_KEY:API_SECRET")
   • Ferramenta online: base64encode.org

Para endpoints v2 (api.transmitmessage.com) - Autenticação por API Key:

Use sua API Key diretamente no cabeçalho x-api-key (não é necessária codificação Base64).

Para endpoints v1 (api.transmitsms.com) - Adicionar aoclaude_desktop_config.json:

JSON

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Importante: Reinicie sua ferramenta de IA após salvar o arquivo de configuração.

Você também pode instalar a integração Claude MCP para este projeto usando:

Bash

claude mcp add kudosity --scope project -- npx mcp-remote https://developers.kudosity.com/mcp

Testando Sua Configuração MCP

Uma vez configurado, você pode testar sua conexão com o servidor MCP:

1. Reinicie sua ferramenta de IA (Claude Desktop, Cursor, etc.)
2. Inicie um novo chat com o assistente de IA
3. Pergunte sobre a Kudosity — experimente perguntas como:
   • "Quais APIs a Kudosity oferece?"
   • "Mostre-me um exemplo de envio de SMS"
   • "Crie um comando curl para enviar meu primeiro SMS pela Kudosity"
   • "Como começo a enviar SMS com a Kudosity?"

Se bem-sucedido, a IA responderá com detalhes da API Kudosity e código de exemplo extraídos diretamente da sua conta e documentação.

Atualizado há cerca de 2 meses

---

Copiar Página