Receitas¶

Adicionar a um projeto Claude Code¶

.mcp.json na raiz do repo:

{
  "mcpServers": {
    "portugal": { "command": "npx", "args": ["-y", "mcp-portugal"] }
  }
}

Prompts que mapeiam para cada ferramenta¶

"Valida o NIF 123456789 e diz o tipo de contribuinte." → validate_nif
"O PT50 0002 0123 1234 5678 9015 4 é um IBAN válido?" → validate_iban
"Lista os feriados nacionais portugueses de 2027." → list_holidays
"O dia 2026-12-08 é feriado em Portugal?" → is_holiday

Chamar programaticamente (cliente MCP)¶

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({ command: 'npx', args: ['-y', 'mcp-portugal'] });
const client = new Client({ name: 'app', version: '1.0.0' });
await client.connect(transport);

const res = await client.callTool({ name: 'validate_nif', arguments: { nif: '123456789' } });
console.log(JSON.parse(res.content[0].text)); // { valid: true, entityType: 'Pessoa singular' }
await client.close();

Combinar com outros servidores MCP¶

{
  "mcpServers": {
    "portugal": { "command": "npx", "args": ["-y", "mcp-portugal"] },
    "latex":    { "command": "npx", "args": ["-y", "mcp-latex"] }
  }
}

Experimentar uma ferramenta com o Inspector¶

npx @modelcontextprotocol/inspector npx -y mcp-portugal
# depois chama list_holidays com { "year": 2026 }