Documentação do Conector PRAXIS

Guia oficial de integração via Model Context Protocol (MCP) para Claude, ferramentas operacionais e boas práticas.

Atualizado em 30 de setembro de 2026 · Compatível com Claude Desktop, Claude.ai, Claude Code e ChatGPT

Em resumo: O PRAXIS fornece ao assistente de IA regras operacionais estruturadas, métodos de trabalho e modelos de entregáveis para quem atende vários clientes, atua num setor de uma empresa ou gerencia um negócio. Seus arquivos locais, notas e documentos confidenciais nunca sobem para os nossos servidores — a conexão MCP entrega exclusivamente regras, modelos e checagem de licença.

1. O que é o PRAXIS

O PRAXIS é um sistema de organização contínua do jeito de trabalhar, montado enquanto você atende clientes, conduz projetos e desenvolve atividades intelectuais. Em vez de ser apenas um pacote estático de instruções ou comandos, ele atua como a infraestrutura operacional que organiza entregas, decisões e memórias de projetos em tempo real.

O PRAXIS é voltado para quem atende vários clientes, para quem trabalha num setor de uma empresa e para o dono de negócio — consultorias, escritórios de contabilidade, advocacia, engenharia, tecnologia, departamentos corporativos e gestão empresarial que realizam trabalho intelectual contínuo.

O sistema adota uma arquitetura híbrida:

Servidor MCP remoto: Hospedado na infraestrutura segura da FilterPro em Cloudflare Workers. Fornece a validação da assinatura, a biblioteca oficial de modelos de entregáveis, as diretrizes de organização por área de atuação e recursos de suporte.
Armazenamento e execução local: Os documentos produzidos, atas, diagnósticos e históricos de clientes residem exclusivamente no computador do usuário (por exemplo, na pasta de trabalho local ~/Praxis/).

2. Pré-requisitos

Antes de conectar o conector PRAXIS, certifique-se de possuir:

Assinatura ativa do PRAXIS: O servidor MCP verifica o status e a vigência da licença em cada chamada de ferramenta.
- Planos disponíveis: Mensal (R$ 89,90/mês), Trimestral (R$ 64,90/mês, cobrado a cada 3 meses) e Anual (R$ 49,90/mês, cobrado em anuidade com economia de 45%).
- Todos os planos contam com garantia incondicional de 14 dias com devolução integral.
- Para contratar ou gerenciar seu plano, consulte a tabela de planos do site ou acesse a página de assinatura do PRAXIS.
Plano pago do Claude (Anthropic): É necessário possuir uma conta Claude Pro, Claude Max, Claude Team ou Claude Enterprise da Anthropic com suporte a conectores MCP no Claude Desktop / Claude.ai ou acesso ao Claude Code.
A assinatura do Claude é contratada e paga diretamente à Anthropic, sendo independente do PRAXIS.

3. Como Conectar

Você pode conectar o PRAXIS à sua plataforma de IA de acordo com o seu fluxo de trabalho:

Opção A: Pelo Diretório do Claude (Recomendado a partir de 01/10)

O caminho recomendado a partir de 01/10/2026 é o diretório de conectores do Claude (Claude Desktop e Claude.ai):

No Claude, acesse Configurações > Conectores.
Procure por PRAXIS e clique em Conectar (ou Add Connector). Nesse caminho não há endereço nem opções para escolher.
Na tela do PRAXIS que se abre, cole o token da sua licença (formato px_...), enviado no seu e-mail de acesso.
Após a confirmação, o conector estará autorizado e as ferramentas do PRAXIS ficarão disponíveis imediatamente em suas conversas.

Para quem preferir ou precisar adicionar manualmente ("Adicionar conector personalizado" com https://mcp.filterpro.dev.br/mcp): a tela mostra Autenticação e Cliente OAuth; mantenha o que vier marcado como "Detectado" (Autenticação: "Entrar agora"; Cliente OAuth: "Usar a identidade publicada do Claude"); Cabeçalhos de requisição: deixar vazio; depois clique em Adicionar > Conectar > colar o token.

Opção B: Pelo Instalador Automatizado (Claude Code no Terminal — Jeito Atual)

Recomendado para usuários técnicos que utilizam o Claude Code no terminal para automação local e comandos de barra:

Após a confirmação da sua assinatura, você recebe por e-mail o seu token individual de acesso (formato px_...).
No Windows, abra o PowerShell e execute o comando oficial de instalação:
```
irm https://praxis.filterpro.dev.br/instalar.ps1 | iex; Instalar-Praxis -Token "<SEU_TOKEN>"
```
(Também é possível baixar o executável oficial de instalação rápida a partir do link enviado no e-mail de boas-vindas).
O instalador automatizado verifica o ambiente, registra o conector MCP remoto no escopo de usuário (claude mcp add ...), baixa a casca de comandos locais para ~/.claude/skills/praxis e prepara a pasta de trabalho ~/Praxis preservando integralmente qualquer dado preexistente.
Abra o Claude Code e execute /praxis:comecar para iniciar o assistente de boas-vindas e configurar sua área de atuação.

Opção C: ChatGPT (Planos Pagos)

Funciona pelo site chatgpt.com (planos pagos; testado no Plus), não nos aplicativos móveis ou desktop.

Na barra da esquerda, acesse Plugins.
No canto superior direito, clique em Adicionar > Novo plugin.
Preencha o Nome como PRAXIS, uma descrição curta, em Conexão selecione URL do servidor e informe https://mcp.filterpro.dev.br/mcp (com /mcp), e em Autenticação selecione OAuth (sem mexer em Configurações avançadas de OAuth).
Marque a opção Entendo e quero continuar e clique em Criar.
Na janela "Conectar a PRAXIS", clique em Continuar em PRAXIS e cole o token da sua licença (formato px_...) na tela do PRAXIS. O ChatGPT confirmará a conexão exibindo a conta em Contas conectadas.
Para verificar o funcionamento, clique em Testar no chat.

Aviso: Os nomes dos menus do ChatGPT podem mudar com o tempo e os comandos com barra (como /praxis:comecar e /praxis:atualizar) são exclusivos do Claude Code. No ChatGPT, o assistente aciona as ferramentas diretamente pelo protocolo MCP.

4. Ferramentas Disponíveis (MCP Tools)

O conector PRAXIS expõe 7 ferramentas operacionais padronizadas e 1 prompt integrado via protocolo MCP. Todas as descrições e parâmetros refletem com exatidão a implementação técnica do servidor:

`praxis_organizacao` Regras & Método

Descrição: Devolve as regras de organização do jeito de trabalhar, com o complemento específico da área de atuação. O assinante ou o assistente pode consultar diretrizes de gestão de contexto, padronização de arquivos e ciclo de vida de projetos.

Parâmetro	Tipo	Obrigatório	Descrição
`area`	string	Não	Área do cliente desta sessão (ex.: `contabil`, `juridico`, `engenharia`, `geral`). Se omitido, utiliza a área cadastrada na licença do assinante.

`praxis_modelo` Entregáveis

Descrição: Lista os modelos de entregáveis disponíveis para o assinante ou devolve o conteúdo estruturado completo de um modelo específico pelo seu nome. Modelos especializados por área sobrepõem os modelos gerais de mesmo nome.

Parâmetro	Tipo	Obrigatório	Descrição
`nome`	string	Não	Nome do modelo desejado (ex.: ata_de_reuniao, diagnostico, plano_de_acao). Se omitido, lista os nomes de todos os modelos disponíveis para o assinante.
`area`	string	Não	Área temática para seleção do modelo. Se omitido, utiliza a área padrão da licença.

`praxis_sugestao` Feedback & Suporte

Descrição: Envia uma sugestão, pedido de recurso ou relato de problema escrito diretamente pelo usuário para a equipe do Praxis. Envia estritamente o texto digitado pelo usuário — nunca anexa conteúdos do Vault local, nomes de clientes, nomes de projetos ou trechos de arquivos.

Parâmetro	Tipo	Obrigatório	Descrição
`texto`	string	Sim	O texto da mensagem, redigido pelo próprio usuário (entre 5 e 2.000 caracteres).
`tipo`	string	Não	Classificação da mensagem: `sugestao`, `problema` ou `skill` (pedido de nova capacidade operacional).

`praxis_exemplo` Referência

Descrição: Devolve um exemplo real de como ficam estruturados os arquivos de um projeto bem organizado no Praxis, por tipo de operação. Útil para verificar o nível de detalhe esperado em arquivos de decisões, estado atual e evidências.

Parâmetro	Tipo	Obrigatório	Descrição
`tipo`	string	Não	Tipo de projeto de exemplo: `app`, `consultoria`, `estudo` ou `negocio`. Se omitido, lista os tipos de exemplos disponíveis.

`praxis_licenca` Conta & Atualizações

Descrição: Informa o e-mail, plano contratado, situação da assinatura (ativo, pendente, cancelado), área cadastrada e a versão da casca atualmente publicada no servidor. Permite verificar se há novas atualizações de comandos e modelos disponíveis.

Parâmetro	Tipo	Obrigatório	Descrição
Esta ferramenta não requer parâmetros de entrada.

`praxis_ajuda` Documentação Integrada

Descrição: Devolve orientações oficiais e respostas para dúvidas frequentes sobre o Praxis, comandos operacionais, continuidade de contexto, suporte e privacidade.

Parâmetro	Tipo	Obrigatório	Descrição
`topico`	string	Não	Tópico de ajuda desejado: `comecar`, `comandos`, `atualizacao`, `continuidade`, `privacidade` ou `suporte`. Se omitido, lista os tópicos disponíveis.

`praxis_skill` Catálogo de Skills

Descrição: Catálogo de skills curadas do Praxis: métodos prontos e revisados para o dia a dia de quem atende clientes — fechar a sessão, relatório de status, proposta, cobrança — e pacotes por área (contabilidade, direito, desenvolvimento de sistemas, engenharia e arquitetura, consultoria, marketing e agências, design e UX, vendas B2B, RH e departamento pessoal, pesquisa acadêmica). Chame sem parâmetros para listar as skills recomendadas para a sua área de atuação ou informe o nome para receber o método estruturado.

Parâmetro	Tipo	Obrigatório	Descrição
`nome`	string	Não	Nome da skill desejada (ex.: `praxis-fechar-sessao`, `juridico-controle-de-prazos`). Se omitido, lista as skills disponíveis.
`area`	string	Não	Área de atuação do usuário (ex.: `direito`, `contabilidade`). Mostra primeiro as skills recomendadas para a sua área.
`todas`	boolean	Não	Se `true`, lista todas as skills do catálogo com descrição completa.

`organizar-cliente` Prompt MCP

Descrição: Prompt parametrizado que orienta o assistente Claude a ler as regras de organização via praxis_organizacao, selecionar o modelo de entregável adequado via praxis_modelo e estruturar o atendimento completo do cliente informado.

Parâmetro	Tipo	Obrigatório	Descrição
`cliente`	string	Sim	Nome do cliente ou projeto a ser organizado.

5. Privacidade e Proteção de Dados

O PRAXIS foi construído sob o princípio fundamental da soberania local dos dados:

Seus documentos não sobem para os nossos servidores: Todo o trabalho intelectual, atas, diagnósticos e dados confidenciais dos seus clientes são gravados apenas no seu disco rígido local.
O que o servidor trata: Apenas os dados estritamente necessários para autenticação e cobrança (e-mail, plano, vigência da licença e metadados técnicos de acesso).
Sem dados sensíveis de terceiros: Não tratamos dados de saúde/médicos e não realizamos transações financeiras em nome dos seus clientes.
Sem anúncios ou patrocinados: Nenhuma ferramenta ou prompt do conector contém links de afiliados ou publicidade embutida.

Para obter detalhes completos sobre os direitos dos titulares e a conformidade com a LGPD, leia nossa Política de Privacidade.

6. Suporte e Atendimento

Dúvidas técnicas, solicitações de apoio ou questões de faturamento são atendidas diretamente pelo time da FilterPro:

E-mail de suporte: filterproconsultoria@gmail.com
WhatsApp oficial: (11) 97603-0442
Tempo de resposta: Atendimento em até 1 dia útil.
Envio de sugestões pelo terminal: Assinantes do Claude Code podem usar a ferramenta praxis_sugestao ou o comando /praxis:sugerir para enviar relatos e pedidos diretamente aos desenvolvedores.

7. Resolução de Problemas Comuns

Erro 401 — "Não autorizado" ou "Licença não encontrada"

Ocorre quando o conector não consegue localizar uma assinatura válida associada às credenciais fornecidas. Confira se o token px_... colado na tela de conexão do Claude é o que veio no seu e-mail de acesso. No instalador local, confirme se o token px_... foi copiado sem omissão de caracteres ou espaços adicionais.

Erro 403 — "Assinatura pendente", "suspensa" ou "cancelada"

Indica que a assinatura está com pagamento pendente ou foi encerrada. O PRAXIS concede 7 dias de tolerância com alertas antes de suspender as requisições. Para regularizar a fatura, acesse o link de pagamento do Asaas ou contate nosso suporte.

Área não reconhecida

Caso o assistente chame praxis_organizacao ou praxis_modelo com uma área inexistente, o servidor retornará um aviso indicando as áreas homologadas no momento (como geral, contabil, juridico e engenharia). Verifique a ortografia do parâmetro.

Ferramentas não aparecem no Claude Code

Abra o terminal e execute claude mcp list. O conector praxis deve estar listado como conectado. Se necessário, reexecute o comando de registro com escopo de usuário: claude mcp add --transport http praxis https://praxis-mcp.filterproconsultoria.workers.dev/mcp --header "Authorization: Bearer <SEU_TOKEN>".

Como atualizar comandos e modelos locais

No terminal do Claude Code, execute /praxis:atualizar. O sistema verifica a versão oficial publicada no servidor MCP e atualiza os modelos e rotinas locais sem modificar ou apagar nenhum dos seus projetos, arquivos e decisões já existentes.

Página Inicial Planos e Assinatura Plataformas compatíveis Termos de Uso Política de Privacidade

Filter Pro Consultoria em Tecnologia Ltda. · CNPJ 65.109.780/0001-58 · Palhoça/SC