Servidor MCP Chameleoon

O que o servidor MCP “Chameleoon” faz?

O Servidor MCP Chameleoon fornece integração perfeita entre a plataforma de gerenciamento de envios Chameleoon e assistentes de IA através do Protocolo de Contexto de Modelo (MCP). Ele permite que empresas de e-commerce, equipes de logística e operações de fulfillment automatizem fluxos de trabalho de envio usando comandos em linguagem natural. O servidor se conecta à plataforma multi-transportadoras Chameleoon, permitindo que assistentes de IA criem pedidos de envio, rastreiem entregas através de vários transportadores, gerem etiquetas de envio em vários formatos, agendem coletas de correio e gerenciem todo o ciclo de vida do envio sem navegação manual no painel. Isso transforma operações logísticas complexas em comandos conversacionais simples, reduzindo drasticamente o tempo gasto em tarefas repetitivas de envio.

Lista de Prompts

Criação e Gerenciamento de Pedidos

Criar um pedido de envio para John Smith na Rua Principal 123, Praga 10000, República Tcheca usando transportadora GLS

Mostrar todos os pedidos de envio criados nos últimos 7 dias

Encontrar todos os pedidos com status 'aguardando' da transportadora DPD

Excluir o pedido de envio com ID 12345

Obter informações detalhadas sobre o pedido ID 67890 incluindo histórico de rastreamento

Rastreamento e Monitoramento de Pacotes

Rastrear pacote com número de envio 06515700194651

Mostrar o status atual e localização de todos os pedidos enviados para a Alemanha este mês

Encontrar as informações de rastreamento para o número de referência PEDIDO-2026-001

Quais pacotes estão atualmente em trânsito e quando devem chegar?

Mostrar todos os pedidos entregues dos últimos 14 dias com suas datas de entrega

Geração de Etiquetas de Envio

Gerar etiquetas de envio A4 para pedidos 123, 456 e 789

Criar etiquetas térmicas em formato A6 para todos os pedidos prontos para coleta hoje

Obter etiquetas em formato ZPL para impressora Zebra para estes números de envio: [lista]

Gerar etiquetas para todos os pedidos GLS criados ontem em formato A4

Seleção de Transportadora e Serviço

Listar todas as transportadoras disponíveis e seus recursos como suporte a coleta e impressão de manifesto

Mostrar quais configurações de transportadora estão disponíveis para envio para a Eslováquia

Quais são os perfis disponíveis para a transportadora DPD?

Agendamento e Gerenciamento de Coletas

Mostrar todos os pedidos elegíveis para coleta de correio hoje

Agendar uma coleta para DPD com estes números de envio: [lista]

Listar todos os pedidos de coleta dos últimos 3 dias agrupados por transportadora

Validação e Controle de Qualidade

Validar este pedido de envio antes de criá-lo: nome do destinatário, endereço, peso e configurações da transportadora

Verificar se este endereço é válido para entrega GLS na Áustria

Validar todos os pedidos aguardando envio e mostrar quaisquer erros ou avisos

Pronto para expandir seu negócio?

Comece seu teste gratuito hoje e veja resultados em dias.

Solicitar demo Entrar

Lista de Recursos

O Servidor MCP Chameleoon não expõe recursos explícitos. Todo acesso a dados é baseado em ferramentas.

Lista de Ferramentas

O Servidor MCP Chameleoon fornece 14 ferramentas abrangentes organizadas em cinco categorias:

Ferramentas de Gerenciamento de Transportadoras

1. list_couriers

• Propósito: Recuperar transportadoras de envio disponíveis com suas capacidades
• Parâmetros: Nenhum
• Retorna: Lista de transportadoras com IDs, nomes, recursos (suporte a coleta, impressão de manifesto)
• Caso de Uso: Determinar quais transportadoras estão disponíveis antes de criar pedidos

2. list_courier_configurations

• Propósito: Obter perfis/configurações de transportadora para criar pedidos de envio
• Parâmetros: Nenhum
• Retorna: Configurações de transportadora disponíveis com IDs de perfil e configurações
• Caso de Uso: Encontrar valores de perfil válidos necessários para criação de pedidos

Ferramentas de Pedidos de Envio

3. list_shipping_orders

• Propósito: Listar e filtrar pedidos de envio
• Parâmetros:
  • date_from (opcional): Data de início (AAAA-MM-DD)
  • date_to (opcional): Data final (AAAA-MM-DD)
  • reference (opcional): Filtrar por número de referência
  • status (opcional): Filtrar por status do pedido
  • state (opcional): Filtrar por estado do pedido
  • courier_id (opcional): Filtrar por transportadora
  • limit (opcional): Máximo de resultados (1-100)
  • offset (opcional): Offset de paginação
• Retorna: Pedidos com URLs de rastreamento, contagem e filtros aplicados
• Caso de Uso: Monitorar pedidos, encontrar remessas específicas, gerar relatórios

4. get_shipping_order

• Propósito: Obter informações detalhadas para um pedido específico por ID interno
• Parâmetros:
  • order_id (obrigatório): Identificador de pedido interno
• Retorna: Detalhes completos do pedido incluindo histórico de rastreamento
• Caso de Uso: Análise profunda de status e histórico de pedido específico

5. get_order_tracking

• Propósito: Rastrear pacote por número de envio/rastreamento da transportadora
• Parâmetros:
  • shipping_number (obrigatório): Número de rastreamento da transportadora
• Retorna: Detalhes do pedido, histórico de rastreamento, estado atual, informações do destinatário, URL de rastreamento
• Caso de Uso: Atendimento ao cliente, atualizações de status de entrega

6. create_shipping_order

• Propósito: Criar novo pedido de envio com transportadora e perfil específicos
• Parâmetros:
  • courier_id (obrigatório): Identificador da transportadora (ex: ‘gls’, ‘dpd’, ‘packeta’)
  • profile (obrigatório): ID do perfil das configurações da transportadora
  • reference_number (obrigatório): Sua referência do pedido
  • recipient_name (obrigatório): Nome completo do destinatário
  • recipient_street (obrigatório): Endereço
  • recipient_city (obrigatório): Cidade
  • recipient_zip (obrigatório): Código postal
  • recipient_country (obrigatório): Código de país ISO (ex: ‘SK’, ‘CZ’)
  • recipient_company (opcional): Nome da empresa
  • recipient_phone (opcional): Número de telefone
  • recipient_email (opcional): Endereço de email
  • package_weight (opcional): Peso em kg
  • package_width (opcional): Largura em cm
  • package_height (opcional): Altura em cm
  • package_length (opcional): Comprimento em cm
  • cod_amount (opcional): Valor de pagamento na entrega
  • cod_currency (opcional): Moeda COD (ex: ‘EUR’)
  • note (opcional): Nota para a transportadora
• Retorna: Confirmação de sucesso, número de envio, URL da etiqueta
• Caso de Uso: Fulfillment automatizado de pedidos, envio em lote

7. delete_shipping_order

• Propósito: Excluir um único pedido de envio
• Parâmetros:
  • order_id (obrigatório): ID do pedido a excluir
• Retorna: Confirmação de sucesso
• Caso de Uso: Cancelar pedidos errados, limpar pedidos de teste

8. delete_shipping_orders_batch

• Propósito: Excluir vários pedidos de uma vez
• Parâmetros:
  • order_ids (obrigatório): Array de IDs de pedidos (máx. 20)
• Retorna: Confirmação de sucesso com contagem de IDs excluídos
• Caso de Uso: Limpeza em massa, cancelamentos em lote

Ferramentas de Validação

9. validate_shipping_order

• Propósito: Validar pedido antes da criação para verificar erros
• Parâmetros: Mesmos de create_shipping_order
• Retorna: Resultados de validação com erros e avisos
• Caso de Uso: Prevenir pedidos falhados, verificar precisão de endereço

Ferramentas de Etiquetas de Envio

10. get_shipping_labels

• Propósito: Gerar etiquetas de envio PDF para pedidos
• Parâmetros:
  • courier_id (obrigatório): Identificador da transportadora
  • profile (obrigatório): Perfil da transportadora
  • shipping_numbers (obrigatório): Array de números de envio
  • label_format (opcional): ‘a4’, ‘a6’ ou ‘zpl’ (padrão: ‘a4’)
  • position (opcional): Posição inicial em folhas de múltiplas etiquetas
• Retorna: Etiquetas em formato PDF codificadas em Base64 ou formato ZPL
• Caso de Uso: Imprimir etiquetas para pacotes, geração automatizada de etiquetas

Ferramentas de Gerenciamento de Coletas

11. list_pickup_orders

• Propósito: Obter pedidos elegíveis para coleta de correio
• Parâmetros:
  • date_from (opcional): Data de início (AAAA-MM-DD)
  • date_to (opcional): Data final (AAAA-MM-DD)
  • state (opcional): Filtrar por estado de coleta
  • courier_id (opcional): Filtrar por transportadora
• Retorna: Pedidos elegíveis para coleta com URLs de rastreamento
• Caso de Uso: Preparar para coleta diária, agendar coletas

12. create_pickup

• Propósito: Agendar solicitação de coleta de correio
• Parâmetros:
  • courier_id (obrigatório): Identificador da transportadora
  • shipping_numbers (obrigatório): Array de números de envio a coletar
• Retorna: Confirmação de coleta, número de coleta, manifesto opcional (base64)
• Caso de Uso: Automatizar coletas diárias, coordenar coletas

Junte-se à nossa newsletter

Receba gratuitamente as últimas dicas, tendências e ofertas.

Endereço de e-mail

Inscrever-se

Casos de Uso deste Servidor MCP

Processamento de Pedidos de Alto Volume

Pressa de Segunda-Feira Pós-Fim de Semana: Ao processar mais de 200 pedidos acumulados durante o fim de semana, criar manualmente cada etiqueta de envio se torna impossível. Em vez de gastar 4-5 horas clicando em painéis, use “Criar pedidos de envio para todos os pedidos pagos de sexta a domingo usando transportadora ideal para cada destino” para processar todo o lote em minutos. A IA seleciona automaticamente a melhor transportadora com base no destino, valida endereços, gera etiquetas e fornece números de rastreamento - transformando uma tarefa que consome a manhã em uma operação de 10 minutos.

Como configurá-lo

Pré-requisitos

• Python 3.10 ou superior instalado
• Conta Chameleoon com acesso à API (registre-se em chameleoon.sk)
• CHAMELEOON_API_KEY válida

Windsurf

1. Obtenha sua chave de API Chameleoon:

   • Faça login em sua conta Chameleoon em chameleoon.sk
   • Navegue até Configurações > Acesso à API
   • Gere ou copie sua chave de API

2. Localize o arquivo de configuração MCP do Windsurf:

   • macOS: ~/Library/Application Support/Windsurf/mcp.json
   • Windows: %APPDATA%\Windsurf\mcp.json
   • Linux: ~/.config/Windsurf/mcp.json

3. Adicione a configuração do servidor MCP Chameleoon:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "sua_chave_api_aqui"
         }
       }
     }
   }
   

4. Salve o arquivo de configuração e reinicie o Windsurf completamente.

5. Verifique a conexão:

   • Abra o painel MCP do Windsurf
   • Procure “chameleoon” na lista de servidores ativos
   • Teste com um comando: “Listar transportadoras disponíveis”

Claude Desktop

1. Obtenha suas credenciais de API Chameleoon em chameleoon.sk (consulte Pré-requisitos).

2. Localize a configuração do Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. Atualize ou crie o arquivo de configuração:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "sua_chave_api_aqui"
         }
       }
     }
   }
   

4. Salve o arquivo e reinicie completamente o Claude Desktop (saia e reinicie).

5. Confirme a conexão do servidor:

   • Abra o Claude Desktop
   • Procure o painel de integrações MCP
   • Verifique se “Servidor MCP Chameleoon” aparece como conectado
   • Teste com: “Mostrar a lista de transportadoras de envio disponíveis”

Cursor

1. Registre-se e obtenha acesso à API em chameleoon.sk (consulte Pré-requisitos).

2. Encontre o arquivo de configuração MCP do Cursor:

   • macOS: ~/Library/Application Support/Cursor/mcp.json
   • Windows: %APPDATA%\Cursor\mcp.json
   • Linux: ~/.config/Cursor/mcp.json

3. Adicione a entrada do servidor MCP:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "sua_chave_api_aqui"
         }
       }
     }
   }
   

4. Salve e reinicie o Cursor.

5. Verifique o status do servidor:

   • Abra o painel MCP do Cursor (Visualizar > Servidores MCP)
   • Certifique-se de que “chameleoon” aparece como ativo
   • Teste: “Listar meus pedidos de envio desta semana”

Cline

1. Obtenha a chave de API Chameleoon em chameleoon.sk.

2. Localize o arquivo de configuração do Cline (a localização varia conforme a instalação do Cline).

3. Adicione o servidor MCP Chameleoon:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "sua_chave_api_aqui"
         }
       }
     }
   }
   

4. Salve, reinicie o Cline e verifique se o servidor aparece nos servidores MCP disponíveis.

5. Teste a conectividade: “Obter lista de configurações de transportadora”

Práticas Recomendadas de Segurança

Nunca codifique diretamente chaves de API. Sempre use variáveis de ambiente:

{
  "mcpServers": {
    "chameleoon": {
      "command": "python3",
      "args": ["-m", "chameleoon_mcp_server"],
      "env": {
        "CHAMELEOON_API_KEY": "${CHAMELEOON_API_KEY}"
      }
    }
  }
}

Em seguida, defina a variável de ambiente no nível do sistema:

• macOS/Linux: Adicione ao ~/.bashrc ou ~/.zshrc: export CHAMELEOON_API_KEY="sua_chave"
• Windows: Defina através de Propriedades do Sistema > Variáveis de Ambiente

Restrinja permissões de chave de API em sua conta Chameleoon apenas às operações necessárias.

Rotacione chaves regularmente e revogue chaves antigas imediatamente se comprometidas.

Use chaves separadas para ambientes de desenvolvimento, staging e produção.

Como usar este MCP dentro de fluxos

Usando MCP no FlowHunt

Para integrar o Servidor MCP Chameleoon ao seu fluxo de trabalho FlowHunt para operações de envio automatizadas, siga estas etapas:

1. Adicione o Componente MCP:
   • Abra seu fluxo FlowHunt ou crie um novo
   • Arraste o componente MCP do painel de componentes
   • Conecte-o ao seu componente de agente de IA

2. Configure o Servidor MCP:
   • Clique no componente MCP para abrir a configuração
   • Na seção de configuração MCP do sistema, insira os detalhes do servidor MCP Chameleoon:

{
  "chameleoon": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.example/caminho/para/chameleoon/mcp"
  }
}

Substitua a URL pelo endpoint real do servidor MCP Chameleoon.

3. Configure Variáveis de Ambiente:

   • Nas configurações de ambiente do FlowHunt, adicione:
     • Chave: CHAMELEOON_API_KEY
     • Valor: Sua chave de API Chameleoon

4. Configure Seu Agente de IA: Uma vez conectado, seu agente de IA pode usar linguagem natural para controlar operações de envio. Exemplos de prompts:

   • “Criar um pedido de envio para o cliente John Smith em…”
   • “Rastrear todos os pedidos de ontem”
   • “Gerar etiquetas para pedidos aguardando envio”
   • “Agendar uma coleta para pedidos DPD”

5. Construa Fluxos de Trabalho Automatizados:

   Exemplo: Fluxo de Fulfillment de Pedido

   • Gatilho: Novo pedido no sistema de e-commerce
   • Ação 1: Extrair endereço do cliente e detalhes do pedido
   • Ação 2: Componente MCP instrui IA: “Criar pedido de envio com estes detalhes: [dados do pedido]”
   • Ação 3: Armazenar número de envio e URL de rastreamento
   • Ação 4: Enviar email de confirmação ao cliente com link de rastreamento

   Exemplo: Relatório Diário de Envios

   • Gatilho: Agendamento (diariamente às 9h)
   • Ação 1: Componente MCP pergunta à IA: “Listar todos os pedidos de ontem”
   • Ação 2: Analisar dados para insights
   • Ação 3: Gerar relatório resumido
   • Ação 4: Enviar para equipe de logística

   Exemplo: Automação de Atendimento ao Cliente

   • Gatilho: Consulta de cliente com número de pedido
   • Ação 1: Extrair número do pedido da mensagem
   • Ação 2: Componente MCP: “Rastrear pacote com referência [número_pedido]”
   • Ação 3: Formatar informações de rastreamento
   • Ação 4: Enviar resposta ao cliente com status e URL de rastreamento

Avaliação do Servidor MCP

Visão Geral

Nossa opinião

O Servidor MCP Chameleoon oferece uma integração robusta e pronta para produção para automação de gerenciamento de envios. Destaca-se pela cobertura abrangente de ferramentas em todo o ciclo de vida do envio - desde seleção de transportadora e criação de pedidos até rastreamento, geração de etiquetas e agendamento de coletas.

Pontos Fortes:

• Cobertura Completa: 14 ferramentas bem projetadas cobrindo todas as operações de envio
• Suporte Multi-Transportadora: Funciona com DPD, GLS, Packeta e outras transportadoras europeias
• Recursos Práticos: URLs de rastreamento universais, múltiplos formatos de etiqueta, operações em lote
• Focado em Negócios: Casos de uso claros para e-commerce, logística e pequenas empresas
• Consciente de Segurança: Configuração de variáveis de ambiente, sem credenciais codificadas

Melhor Para:

• Empresas de e-commerce automatizando fulfillment de pedidos
• Equipes de logística gerenciando operações multi-transportadoras
• Pequenas empresas buscando automação de envios sem APIs complexas
• Desenvolvedores construindo fluxos de trabalho de envio no FlowHunt ou plataformas similares
• Equipes de atendimento ao cliente precisando de acesso rápido a informações de rastreamento

Limitações:

• Foco regional (principalmente transportadoras europeias)
• Requer conta Chameleoon e acesso à API
• Sem recursos expostos (todo acesso é baseado em ferramentas)

O servidor transforma interações complexas de API de envio em comandos simples em linguagem natural, tornando a automação logística avançada acessível a usuários não técnicos, enquanto fornece controle programático abrangente a usuários avançados.

Pontuação MCP

Nota: Contagens de fork e star não estão disponíveis, pois este é um servidor MCP interno/proprietário.