pfx MCP - Model Context Protocol Forterro Proffix Px5

A integração universal de IA/IC com o ERP Proffix Px5

Ver em pfx.chExperimente este MCPPatrocinado

Documentação

⚠️ Mudança Importante: Nova Convenção de Nomes para Ferramentas

A partir desta versão: Por padrão, apenas as novas ferramentas px_* são retornadas. As ferramentas legadas (proffix_search_endpoints, proffix_call_endpoint, proffix_describe_endpoint) não estão mais disponíveis automaticamente.

🚨 Ativar Modo Legado (se você precisar das ferramentas antigas):

  • Cabeçalho: X-Legacy-Mode: 1
  • Chatbot: Use o botão de alternância no cabeçalho
  • Observação: Ferramentas legadas serão removidas em versões futuras

Recomendado: Migre para as novas ferramentas px_* para melhor desempenho e integração preparada para o futuro. → Detalhes nos Métodos da API

🌟 O que é o Model Context Protocol (MCP)?

Model Context Protocol (MCP) é um padrão aberto da Anthropic para integração segura de IA. Assistentes de IA acessam diretamente seus sistemas - sem cópias manuais de dados ou capturas de tela.

💡 MCP na prática - Um exemplo:

Sem MCP: "Mostre-me todas as faturas em aberto" → Você precisa abrir o Proffix, exportar dados, copiar para a IA
Com MCP: "Mostre-me todas as faturas em aberto" → A IA acessa diretamente o Proffix e fornece a resposta

✨ Vantagens do MCP:

  • Acesso em tempo real: A IA trabalha com dados atuais dos seus sistemas
  • Segurança: Nenhum dado é armazenado na IA - apenas acesso temporário
  • Automação: A IA pode executar tarefas complexas em vários sistemas
  • Linguagem natural: Não são necessários conhecimentos de SQL ou API
  • Padronizado: Funciona com todos os assistentes de IA compatíveis com MCP

📋 O que é pfx MCP?

pfx MCP é o primeiro servidor MCP para Forterro Proffix Px5. Conecte assistentes de IA como Claude, ChatGPT e Gemini ao seu ERP. Acesse dados, crie relatórios e automatize fluxos de trabalho - diretamente por linguagem natural.

🔐 Segurança: Autenticação baseada em parâmetros, sem sessões. As credenciais são transmitidas criptografadas e nunca armazenadas.

✨ Recursos:

  • Praticamente todas as funções do Proffix via ferramentas MCP
  • Transporte JSON-RPC 2.0 para todos os clientes MCP
  • Chave de API gratuita (Beta)
  • Pronto para Claude, ChatGPT, Gemini
  • Demonstração online com banco de dados público de demonstração do Proffix (apenas chave LLM necessária)

🌐 Listado oficialmente no Registro MCP:

O servidor pfx MCP está oficialmente listado no Model Context Protocol Registry da Anthropic:
📦 Pacote: ch.pfx/mcp-server
🔗 Registro: registry.modelcontextprotocol.io
💻 GitHub: github.com/pitwch/pfx-mcp-server
✅ Status: Ativo • Versão 1.1.8 • Publicado em 13.11.2025

💡 Casos de uso práticos

Descubra como o pfx MCP revoluciona seu trabalho diário com o Proffix Px5:

📊 Consultas inteligentes de dados

Exemplo: "Mostre-me todas as faturas em aberto"

A IA acessa diretamente seus dados do Proffix e fornece resultados estruturados - sem conhecimentos de SQL ou API.

🔍 Buscas complexas

Exemplo: "Procure artigos com 'Laptop' no nome e preço abaixo de 1000 CHF"

Consultas em linguagem natural são convertidas automaticamente em chamadas de API precisas.

📈 Relatórios automáticos

Exemplo: "Crie um relatório sobre os 10 principais clientes por faturamento"

A IA agrega dados, cria análises e formata resultados profissionalmente.

🔔 Rastreamento de alterações

Exemplo: "Quais endereços foram alterados esta semana?"

Consultas baseadas em tempo e análises de alterações em tempo real.

💼 Análises de clientes

Exemplo: "Analise a evolução de faturamento do cliente 1001"

Perfis detalhados de clientes com histórico de faturamento, pedidos e tendências.

📦 Gestão de estoque

Exemplo: "Mostre-me todos os artigos com estoque abaixo de 10"

Monitoramento de estoque e alertas automáticos para níveis baixos.

🔄 Automação de fluxos de trabalho

Exemplo: "Crie um novo endereço para a empresa XY com dados de contato"

Automatize tarefas recorrentes por meio de comandos em linguagem natural.

📋 Consultas multi-sistema

Exemplo: "Compare dados do Proffix com nosso CRM"

Combine dados de vários sistemas para análises abrangentes.

🎯 Descoberta de endpoints

Exemplo: "Quais endpoints de API existem para pedidos?"

Busca difusa em funções - encontre rapidamente a operação de API correta.

🚀 Outros casos de uso:

  • Contabilidade: "Mostre todas as faturas não pagas com mais de 30 dias"
  • Vendas: "Liste todas as propostas do Q4 2024 com status 'Aberta'"
  • Compras: "Quais pedidos estão atrasados?"
  • Controladoria: "Crie um resumo de faturamento por grupos de produtos"
  • Suporte: "Encontre todos os casos de serviço do cliente XY"
  • Desenvolvimento: "Documente todos os endpoints disponíveis do Proffix"

🤖 Integração AI/IA para Proffix Px5

Gemini e Claude em uso com Proffix Px5 - Consultas em linguagem natural diretamente em seus dados ERP

Conecte sua instalação Forterro Proffix Px5 com os principais assistentes de AI/IA. O servidor pfx MCP suporta todas as plataformas de IA compatíveis com MCP para consultas inteligentes de dados do Proffix Px5:

🤖 Claude Desktop

O aplicativo Claude Desktop da Anthropic com suporte nativo a MCP.

🧠 OpenAI / ChatGPT

ChatGPT com integração MCP via Custom Actions ou API.

✨ Google Gemini

A IA Gemini do Google com integração MCP via API.

💎 Gemini CLI

O Gemini do Google com suporte nativo a MCP via CLI.

💻 Cursor IDE

Editor de código com tecnologia de IA e suporte a MCP.

🔍 MCP Inspector

Ferramenta oficial de teste e depuração MCP.

🔌 MCP SuperAssistant

Extensão de navegador para ChatGPT, Perplexity, Gemini e mais.

⚙️ Cliente personalizado

Integração própria com JavaScript, Python, etc.

💬 Chatbot Webview

Zero instalação: Chatbot HTML pronto com IA Gemini – teste online ou baixe.

🧪 Testar agora (Demonstração) ⬇ baixar chatbot.html

ℹ️ Observação sobre ChatGPT e OpenAI:

  • Integração MCP do ChatGPT: Requer atualmente um plano pago do ChatGPT com Developer Mode (ex.: Plus/Team/Enterprise). A disponibilidade pode mudar.
  • Integração com a API OpenAI: Funciona sem ChatGPT Premium. Requer apenas uma chave de API OpenAI (pagamento conforme uso).

📖 Guias de configuração para todos os clientes de IA 🚀 Início rápido (5 min)

🔑 Autenticação segura para Forterro Proffix Px5

O servidor pfx MCP usa autenticação segura baseada em parâmetros para sua API REST Proffix Px5. As credenciais são transmitidas criptografadas como cabeçalhos HTTP e nunca armazenadas.

🔑 Chave de API: OBRIGATÓRIA E GRATUITA
→ Solicite agora sua chave de API gratuita (30 segundos)
✨ Gratuita durante o beta • Uma chave por e-mail • Simples • Protege apenas contra bots/SPAM (sem acesso a dados)

🚀 Como usar sua chave de API:

1️⃣ Claude Desktop (Recomendado):

{
  "mcpServers": {
    "pfx-mcp": {
      "command": "node",
      "args": ["C:\\mcp\\mcp-http-bridge.js", "https://mcp.pfx.ch/api/server"],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer DEIN_API_KEY_HIER",
        "PROFFIX_USERNAME": "dein-user",
        "PROFFIX_PASSWORD": "dein-passwort",
        "PROFFIX_URL": "https://dein-proffix.com",
        "PROFFIX_PORT": "dein-port",
        "PROFFIX_DATABASE": "deine-db"
      }
    }
  }
}

2️⃣ Chamadas diretas de API:

Authorization: Bearer pfx_abc123...xyz789

ou

X-API-Key: pfx_abc123...xyz789

3️⃣ Exemplo com CURL:

curl -H "Authorization: Bearer DEIN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' \
     https://mcp.pfx.ch/api/server

X-Proffix-Username (cabeçalho, opcional)

Seu nome de usuário da API Proffix. Omita no modo LoginToken (apenas o token é necessário como senha).

X-Proffix-Password (cabeçalho)

Senha do Proffix ou LoginToken.
💡 Modo normal: senha em texto claro ou hash SHA256 (64 caracteres hexadecimais). Modo LoginToken: omita X-Proffix-Username e insira o token diretamente aqui — ele não será submetido a hash.

X-Proffix-Url (cabeçalho)

A URL base do seu servidor de API REST Proffix, sem /pxapi/...

X-Proffix-Port (cabeçalho, opcional)

Porta do servidor de API Proffix (ex.: 11011)

X-Proffix-Database (cabeçalho, opcional)

Nome do banco de dados Proffix

X-Proffix-Modules (cabeçalho, opcional)

Módulos Proffix para a sessão (padrão: VOL). Separados por vírgula ou múltiplos.

Exemplos: VOL · AUF

X-Legacy-Mode (cabeçalho, opcional) ⚠️ MUDANÇA IMPORTANTE

Mudança importante: Defina como 1 para ativar ferramentas legadas (proffix_search_endpoints, proffix_call_endpoint, proffix_describe_endpoint) além das ferramentas px_*.

Comportamento padrão (novo): Apenas ferramentas px_* são retornadas.
Modo legado: Defina X-Legacy-Mode: 1 para também receber as ferramentas antigas.
Chatbot: Controlável pelo botão de alternância no cabeçalho.

⚠️ Ferramentas legadas serão removidas em versões futuras. Migração para px* recomendada.

⚠️ Importante: As credenciais não são armazenadas. Sempre use HTTPS.

🔌 API Model Context Protocol para Proffix Px5

O servidor pfx MCP implementa o Model Context Protocol padronizado via JSON-RPC 2.0 para integração perfeita de AI/IA com Forterro Proffix Px5:

initialize

Handshake entre cliente e servidor. Troca capacidades e versão do protocolo.

⚠️ tools/list

Lista todas as operações Proffix disponíveis.

Mudança importante:
Padrão: Apenas ferramentas px_*
Legado: Cabeçalho X-Legacy-Mode: 1 para ferramentas antigas

tools/call

Executa uma operação Proffix. Os parâmetros são passados em arguments.

📡 Endpoint da API: https://mcp.pfx.ch/api/server
🔒 Transporte: HTTP POST com JSON-RPC 2.0
🔑 Autenticação: Cabeçalhos HTTP (X-Proffix-*)

🔧 Exemplos de teste e depuração ℹ️ Informações da versão

🔒 Segurança para integração AI/IA do Proffix Px5

✅ Recursos de segurança:

  • As credenciais são transmitidas a cada solicitação e não são armazenadas
  • Sem gerenciamento de usuários ou armazenamento de sessão
  • Criptografia HTTPS recomendada
  • Regras abrangentes de segurança .htaccess
  • Proteção de arquivos sensíveis e configurações

⚠️ Boas práticas:

  • Sempre use HTTPS para comunicação
  • Nunca armazene credenciais no código do cliente
  • Implemente limite de taxa no lado do cliente
  • Monitore acessos à API regularmente
  • Use senhas fortes para usuários da API Proffix

🚀 Início rápido - Pronto em 5 minutos

Conecte seu assistente de IA ao Proffix Px5 em poucos passos. A solução ERP Forterro torna-se utilizável de forma inteligente.

✅ O que você precisa:

  • Acesso ao Proffix Px5: Nome de usuário + senha ou LoginToken, URL do servidor, porta, banco de dados
  • Cliente de IA: Claude Desktop (recomendado), ChatGPT, Gemini ou outro cliente MCP
  • Chave de API: Solicite gratuitamente (30 segundos)

🎯 Recomendado: Instalação com um clique (Claude Desktop)

O método mais rápido - sem configuração manual necessária!

  1. Obtenha a chave de API: Visite request-api-key.html e solicite sua chave gratuita (por e-mail)
  2. Carregue o pacote MCPB: Baixe pfx-mcp-server.mcpb
  3. Instale: No Claude Desktop: Configurações → Extensões → Configurações avançadas (área Desenvolvedor de extensões) → Instalar extensão… → selecione o arquivo .mcpb e siga as instruções
  4. Insira as credenciais: Chave de API + suas credenciais do Proffix Px5 (nome de usuário, senha, URL, porta, banco de dados)
  5. Pronto! Reinicie o Claude e teste: "Mostre-me todos os endereços de Zurique do Proffix Px5"

💡 O que é um pacote MCPB?
Um MCPB (Model Context Protocol Bundle) contém todos os arquivos e configurações necessários. A instalação é feita no Claude Desktop via Configurações → Extensões → Configurações avançadas → Instalar extensão…. Depois, basta inserir suas credenciais.

⚙️ Alternativa: Instalação manual

Para outros clientes MCP (Cursor, Windsurf, Gemini CLI, etc.) ou se você preferir gerenciar a configuração manualmente:

  1. Solicite a chave de API: request-api-key.html
  2. Carregue o script de ponte: Baixe mcp-http-bridge.txt e renomeie para mcp-http-bridge.js
  3. Abra o arquivo de configuração: Dependendo do cliente (ex.: %APPDATA%\Claude\claude_desktop_config.json para Claude)
  4. Adicione o servidor: Veja a configuração de exemplo abaixo
  5. Reinicie o cliente e teste

📋 Configuração de exemplo:

{
  "mcpServers": {
    "pfx-mcp": {
      "command": "node",
      "args": ["C:\\mcp\\mcp-http-bridge.js", "https://mcp.pfx.ch/api/server"],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer DEIN_API_KEY",
        "PROFFIX_USERNAME": "dein-user",
        "PROFFIX_PASSWORD": "dein-passwort",
        "PROFFIX_URL": "https://dein-proffix.com",
        "PROFFIX_PORT": "11011",
        "PROFFIX_DATABASE": "deine-db"
      }
      // LoginToken-Modus: PROFFIX_USERNAME weglassen, Token als PROFFIX_PASSWORD
    }
  }
}

📦 Download do pacote MCPB 📚 Todos os guias de clientes de IA 🔧 Testes e depuração

⚙️ Detalhes técnicos

🔌 Protocolo MCP

  • Transporte: JSON-RPC 2.0
  • Métodos: initialize, tools/*, prompts/*, resources/*
  • HTTP POST para /api/server 🔒 Autenticação
  • API Key: Authorization: Bearer
  • Proffix: Cabeçalhos HTTP (X-Proffix-*)
  • LoginToken: X-Proffix-Username deixe vazio, token como X-Proffix-Password
  • Sem sessões, sem armazenamento

📦 Informações do Servidor

  • Versão: 1.7.1
  • Build: 2026-07-14
  • Base: mcp.pfx.ch

📡 Endpoints:

  • /api/server - Endpoint MCP JSON-RPC 2.0
  • /api/version - Informações de versão e build do servidor

🤖 Otimizado para LLM e econômico em tokens

  • Respostas compactas: respostas GET removem campos nulos/vazios automaticamente
  • Formato TOON: Notação de Objeto Orientada a Tokens com formato tabular para até 30% menos tokens - basta passar format=toon como parâmetro
  • API Describe com níveis de detalhe: overview, compact, full (para resultados rápidos e amigáveis para LLM)
  • Conteúdo de múltiplas partes: blocos de código Markdown e JSON claramente separados
  • Melhores práticas: use fields, defina limit/offset, restrinja filter, mantenha depth pequeno

🎯 Formato TOON - Respostas Otimizadas para Tokens

TOON (Token-Oriented Object Notation) é um formato de dados compacto baseado na especificação oficial TOON, projetado especificamente para LLMs. Ele reduz a quantidade de tokens em até 30% em comparação com JSON.

✨ Vantagens do TOON:

  • Menos tokens: Até 30% de redução em relação ao JSON
  • Processamento mais rápido: Menos dados = respostas de LLM mais rápidas
  • Economia de custos: Menos tokens = menores custos de API
  • Formato Tabular: Arrays de objetos são exibidos de forma ultracompacta como tabela
  • Ativação simples: Basta passar format=toon como parâmetro

📝 Uso

O TOON pode ser ativado de duas maneiras:

Opção 1: Global para todas as chamadas (recomendado)

Defina format no nível de arguments:

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "format": "toon",
    "params": {
      "limit": 10
    }
  }
}

Opção 2: Por chamada

Defina format em params para chamadas individuais:

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "params": {
      "limit": 10,
      "format": "toon"
    }
  }
}

💡 Prioridade: params.format substitui arguments.format. Assim, você pode ativar o TOON globalmente e usar JSON para chamadas individuais.

🔄 Comparação de Formatos

JSON Padrão (Pretty):

[{
  "AdressNr": 1349,
  "Name": "Mustermann AG",
  "PLZ": "9000",
  "Ort": "St. Gallen"
}]

~90 caracteres ≈ 23 tokens

Formato TOON (Tabular):

[1]{AdressNr,Name,PLZ,Ort}: 1349,"Mustermann AG",9000,"St. Gallen"

~65 caracteres ≈ 16 tokens (economia de 30%)

📖 Exemplos de Formato TOON:

  • Objeto simples: AdressNr: 1349 Name: "Mustermann AG" PLZ: 9000
  • Arrays primitivos: tags[3]: admin,user,guest
  • Arrays tabulares: items[2]{id,name}: 1,Ada 2,Bob
  • Aninhado: user: id: 1 name: Ada active: true

💡 Quando devo usar TOON?

  • Grandes volumes de dados: Em listas com muitos itens (>10 itens)
  • Chamadas frequentes de API: Para reduzir custos de tokens
  • Arrays de objetos: Beneficiam-se mais do formato tabular
  • Limites de tokens: Quando você está próximo dos limites de tokens do LLM

ℹ️ Nota: O LLM é informado automaticamente quando o formato TOON é usado. A resposta contém um campo _meta com informações de formato. Mais detalhes: Especificação TOON

📞 Perguntas e Suporte

Tem dúvidas sobre pfx MCP ou precisa de suporte na integração com Proffix Px5? Nossa equipe está à disposição!

Pedrett IT+Web AG

Murgtalstrasse 20
9542 Münchwilen
Suíça

📞 Telefone: 071 966 66 00
✉️ E-mail: [email protected]
🌐 Site: www.pitw.ch

💡 Nós ajudamos você com:

  • Integração do pfx MCP com sua instalação Proffix Px5
  • Configuração de clientes de IA (Claude, ChatGPT, Gemini)
  • Desenvolvimento de MCP personalizado e adaptações para Forterro Proffix
  • Solução de problemas e suporte técnico
  • Treinamentos e workshops