# MCP Builder

> Criar MCP servers para integrar APIs externas ao Claude. Usar quando precisar conectar a servicos externos, criar ferramentas customizadas, ou integrar APIs de terceiros.

- Skill: `henriquescastilho/mcp-builder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add henriquescastilho/mcp-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriquescastilho/mcp-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: henriquescastilho (https://skillmd.com/u/henriquescastilho)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/henriquescastilho/mcp-builder

---


# Construtor de MCP Servers -- Padrao DME

## Stack recomendada

| Linguagem | Framework | Quando usar |
|-----------|-----------|-------------|
| Python | FastMCP | Maioria dos casos |
| TypeScript | @modelcontextprotocol/sdk | Projeto ja e TS |

## Estrutura minima (Python)

```python
from fastmcp import FastMCP
mcp = FastMCP("nome-do-servico")

@mcp.tool()
def minha_ferramenta(parametro: str) -> str:
    """Descricao clara do que faz."""
    return resultado
```

## Boas praticas

- Cada tool faz UMA coisa
- Descricoes claras nos tools
- Tipos explicitos em parametros
- Erros retornam mensagem util, nao stack trace
- Auth via env vars
- Rate limiting se API externa tem limites
- Timeout em chamadas externas

## Registro em ~/.claude/.mcp.json

```json
{
  "mcpServers": {
    "nome": {
      "command": "python",
      "args": ["/caminho/server.py"]
    }
  }
}
```

## Seguranca

- Nunca expor credenciais nos logs
- Validar todo input
- HTTPS para chamadas externas
- Permissoes minimas