Octura Solutions Site Tools

Octura Solutions Site Tools (servidor MCP)

Um servidor Model Context Protocol hospedado que expõe 30 ferramentas somente leitura: 25 calculadoras ERP determinísticas (custos de implementação, migração e upgrade do Odoo, ROI e custo total de propriedade, imposto sobre vendas para EUA, Canadá e UE, deduções de folha de pagamento canadenses e cálculos de inventário como ponto de pedido, estoque de segurança e LEC), além de cinco consultas de conteúdo que retornam páginas da Octura, preços do Odoo e comparações com concorrentes para citação.

Endpoint: https://octurasolutions.com/mcp (HTTP transmissível) Registro: com.octurasolutions/site-tools

Nada para instalar e nenhuma chave de API. É um servidor remoto, então você aponta seu cliente para a URL.

Por que são ferramentas e não uma resposta de chat

Cada calculadora é uma função pura: mesmas entradas, mesmas saídas, sem modelo no processo e sem aleatoriedade. Pedir a um modelo de linguagem para calcular um período de retorno ou um total de QST de Quebec convida a um número errado com aparência plausível. Elas retornam a aritmética, junto com as entradas usadas, para que o resultado possa ser verificado.

A contrapartida é que são calculadoras, não aconselhamento. Elas não conhecem o seu negócio, e os modelos de custo carregam premissas (taxas regionais, custos horários combinados) que uma cotação real substituiria.

Adicione ao seu cliente

Claude Code:

claude mcp add --transport http octura https://octurasolutions.com/mcp

Qualquer cliente que leia uma configuração JSON:

{
  "mcpServers": {
    "octura": {
      "type": "streamable-http",
      "url": "https://octurasolutions.com/mcp"
    }
  }
}

O servidor é sem estado e somente ferramentas. Ele implementa initialize, ping, tools/list e tools/call; não anuncia recursos nem prompts.

Se o seu cliente só fala stdio

A maioria dos clientes lida com HTTP remoto diretamente e deve usar a configuração acima. Para os mais antigos que só suportam stdio, este repositório traz uma ponte:

npx -y github:Octura-solutions/octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "npx",
      "args": ["-y", "github:Octura-solutions/octura-mcp-server"]
    }
  }
}

Ou com Docker, docker build -t octura-mcp . && docker run -i --rm octura-mcp.

Clientes Python podem instalá-lo do PyPI:

uvx octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "uvx",
      "args": ["octura-mcp-server"]
    }
  }
}

A ponte Node é executada a partir deste repositório em vez de um nome de pacote npm, porque não é publicada no npm; a versão Python está no PyPI. Ambas são o mesmo pipe com o mesmo comportamento, verificado pelos mesmos oito testes em cada linguagem. Escolha o runtime que seu cliente já possui.

A ponte é um pipe: ela envia via POST o que chega no stdin para o endpoint e escreve a resposta de volta. Não tem dependências e não reafirma a lista de ferramentas nem nenhum esquema, então não pode ficar dessincronizada com o servidor. Aponte para outro lugar com OCTURA_MCP_URL.

Um exemplo prático

curl -s -X POST https://octurasolutions.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"odoo-roi-calculator",
        "arguments":{"currentAnnualCost":60000,"odooAnnualCost":18000,
                     "implementationCost":45000,"annualEfficiencySavings":30000}}}'

O conteúdo de text é JSON, ecoando a entrada junto com o resultado:

{
  "tool": "odoo-roi-calculator",
  "input": {
    "currentAnnualCost": 60000,
    "odooAnnualCost": 18000,
    "implementationCost": 45000,
    "annualEfficiencySavings": 30000
  },
  "result": {
    "annualNetSavings": 72000,
    "paybackMonths": 7.5,
    "threeYearNet": 171000,
    "threeYearRoiPercent": 380
  }
}

Toda entrada tem um padrão documentado, então uma ferramenta chamada com {} ainda retorna uma linha de base sensata em vez de um erro.

As ferramentas

Cada uma também existe como uma página interativa, que é a maneira mais fácil de ver o que uma ferramenta espera antes de conectá-la.

Custo e planejamento do Odoo

Ferramenta	O que retorna
odoo-implementation-cost-calculator	Estime seu orçamento de implementação do Odoo
odoo-migration-cost-calculator	Estime o custo de migrar para o Odoo
odoo-upgrade-cost-calculator	Orce um upgrade de versão do Odoo
odoo-total-cost-of-ownership-calculator	Modele o custo total plurianual do Odoo
odoo-roi-calculator	Estime o retorno e o ROI plurianual do Odoo
odoo-sh-pricing-calculator	Estime seu custo de hospedagem no Odoo.sh
odoo-stack-savings-calculator	Veja o que consolidar ferramentas no Odoo economiza
odoo-edi-readiness-cost-estimator	Estime o custo de integração EDI no Odoo
odoo-app-selector	Encontre os aplicativos do Odoo que sua empresa precisa
erp-selection-tool	Pontue sua lista de ERP mais adequada entre 10 sistemas
odoo-conf-tuner	Ajuste workers e limites de memória do odoo.conf
odoo-project-rescue-risk-grader	Avalie o quão mal está indo uma implementação do Odoo em andamento

Impostos

Ferramenta	O que retorna
us-sales-tax-calculator	Imposto sobre vendas estadual para todos os 50 estados e DC
us-sales-tax-nexus-checker	Veja onde você deve cobrar imposto sobre vendas nos EUA
canadian-sales-tax-calculator	GST, HST, PST e QST para todas as províncias
eu-vat-calculator	Alíquotas de IVA por país, além da validação VIES
canadian-payroll-source-deductions-calculator	Deduções de CPP, EI e imposto de renda na fonte

Inventário e operações

Ferramenta	O que retorna
inventory-turnover-calculator	Índice de giro e dias de inventário
reorder-point-calculator	Quando reordenar, com estoque de segurança
safety-stock-calculator	Estoque de segurança para variações de demanda e lead time
economic-order-quantity-calculator	Quantidade ideal de pedido para minimizar custo
inventory-carrying-cost-calculator	Custo anual de manter inventário
landed-cost-calculator	Custo real por unidade, incluindo frete e imposto de importação
margin-and-markup-calculator	Converta entre margem, markup e preço
oee-calculator	Eficácia Geral do Equipamento para produção

Conteúdo da Octura

Estas são consultas, não calculadoras. Elas retornam páginas e fatos de octurasolutions.com para que um modelo possa responder com uma fonte para citar em vez de usar a memória.

Ferramenta	O que retorna
ask_octura	As páginas do site mais relevantes para uma pergunta sobre Odoo ou ERP, com URLs
compare_odoo_vs	Comparação direta do Odoo contra um de 60 concorrentes
find_odoo_apps_for	Aplicativos e módulos do Odoo que atendem a uma necessidade de negócio em linguagem simples
get_odoo_pricing	Preços atuais da lista de licenças do Odoo e taxas de hospedagem do Odoo.sh
get_partner_profile	Quem é a Octura Solutions: status de parceiro, regiões, serviços, contato

Descrições legíveis por máquina

Para catálogos, carregadores de plugins e qualquer outra coisa que queira a API descrita sem falar MCP primeiro, o repositório traz três arquivos:

Arquivo	O que é
tools.json	A resposta tools/list literal, mais o serverInfo de initialize
openapi.json	OpenAPI 3.1 para o endpoint, com um esquema de requisição tipado por ferramenta
.well-known/ai-plugin.json	Manifesto de plugin apontando para o documento OpenAPI

Os dois primeiros são gerados a partir do endpoint ativo por npm run discovery, então são um instantâneo em vez de uma segunda fonte de verdade: se discordarem do servidor, o servidor está certo e a correção é executar o script novamente. npm test verifica se os três arquivos concordam entre si.

Limites

Limite de taxa por IP. Leia X-RateLimit-Limit e X-RateLimit-Remaining na resposta em vez de codificar um número fixo, pois o teto pode mudar. Acima do limite, retorna HTTP 429 com um cabeçalho Retry-After.

As alíquotas de impostos e os valores de folha de pagamento são mantidos com base no melhor esforço e não substituem o aconselhamento de declaração de um contador.

Sobre este repositório

Este repositório é a casa pública do servidor: este README, uma cópia do manifesto de registro server.json publicado, as descrições legíveis por máquina acima e a ponte stdio. As calculadoras em si são executadas dentro do site da Octura Solutions, cujo código-fonte é privado, então o que você pode construir e executar aqui é a ponte, não as ferramentas.

Execute os testes da ponte com npm test. Eles usam um substituto local para o endpoint, então passam sem acesso à rede.

Detalhes sobre o servidor, incluindo a lista completa de ferramentas com esquemas de entrada, estão em octurasolutions.com/tools/mcp-server.

Encontrou um número errado ou uma ferramenta com erro? Abra uma issue.

Licença

MIT, veja LICENSE. Isso cobre o conteúdo deste repositório. O serviço hospedado é oferecido como está, sob os termos do site.