@page "/docs/mcp" @model Nalu.Web.Pages.Docs.McpModel @{ ViewData["Title"] = "MCP Server — NALU AI Docs"; ViewData["Description"] = "Integre NALU AI com Claude Code, Cursor e qualquer cliente MCP via JSON-RPC 2.0."; }
Docs / MCP Server

MCP Server

Use os validadores NALU como ferramentas nativas no Claude Code, Cursor e qualquer cliente MCP.

O que é MCP?

Model Context Protocol (MCP) é um protocolo aberto que permite agentes de IA chamarem ferramentas externas de forma padronizada. O NALU AI expõe todos os validadores como ferramentas MCP via JSON-RPC 2.0 sobre stdio ou HTTP/SSE.

Configurar no Claude Code

Adicione ao seu ~/.claude/settings.json:

{
  "mcpServers": {
    "nalu": {
      "command": "npx",
      "args": ["-y", "@@naluai/mcp-server"],
      "env": {
        "NALU_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Ou via HTTP (se preferir não usar npx):

{
  "mcpServers": {
    "nalu": {
      "url": "https://api.naluai.com/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY"
      }
    }
  }
}

Configurar no Cursor

Acesse Settings → MCP → Add Server e adicione:

Name: NALU AI
URL:  https://api.naluai.com/mcp
Headers:
  Authorization: Bearer SUA_API_KEY

Ferramentas disponíveis

Após conectar, o agente de IA enxerga estas ferramentas:

@foreach (var t in new[] { ("validate_cpf", "Extrai e valida CPF de texto em linguagem natural"), ("validate_cep", "Extrai CEP e retorna endereço completo"), ("validate_cnpj", "Extrai e valida CNPJ"), ("validate_email", "Extrai email com correção de typos"), ("validate_phone_br", "Extrai telefone brasileiro com DDD"), ("validate_plate_br", "Extrai placa Mercosul ou formato antigo"), ("validate_postal_code", "Código postal internacional"), ("validate_full_name", "Extrai nome completo, ignora saudações"), ("validate_yes_no", "Detecta sim/não em linguagem natural"), ("validate_birthdate", "Extrai data de nascimento"), ("validate_handoff", "Detecta intenção de falar com humano"), ("validate_cancel_intent", "Classifica intenção de cancelamento"), ("validate_company_name", "Extrai nome de empresa"), ("validate_reply", "Analisa contexto conversacional completo"), }) { }
Ferramenta Descrição
@t.Item1 @t.Item2

Exemplo de uso no Claude Code

Prompt para o Claude:

"O usuário disse 'meu cpf é 111.444.777-35'. Use validate_cpf para extrair e validar."

Claude chama automaticamente:

validate_cpf({
  "agent_input": "Qual o seu CPF?",
  "user_input":  "meu cpf é 111.444.777-35"
})