Pular para o conteudo
MODULO 3-4

๐Ÿ—„๏ธ MCPs de Database e APIs

Conecte o agente a PostgreSQL, Redis, APIs REST e GraphQL. Aprenda a acessar servicos reais com seguranca e a proteger credenciais.

6
Topicos
~45
Minutos
M3.2
Pre-requisito
Pratico
Tipo
Progresso:0%0 de 6
1

๐Ÿ˜ PostgreSQL MCP

O PostgreSQL MCP conecta o agente a bancos Postgres via connection string. Tools: query (rodar SQL), list_tables, describe_table. O agente pode analisar schemas, gerar reports, debugar dados e ate sugerir indices.

A configuracao passa a connection string como variavel de ambiente: POSTGRES_URL=postgresql://user:pass@host:5432/db. Sempre prefira read-only para ambientes de producao.

settings.json (postgres)
"postgres": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-postgres"],
  "env": { "POSTGRES_URL": "postgresql://user:pass@localhost:5432/mydb" }
}

Em 1 frase: PostgreSQL MCP = o agente faz queries SQL em bancos Postgres reais.

2

โšก Redis MCP

O Redis MCP expoe operacoes de cache e key-value: get, set, keys, ttl, del. Util para debugar cache, verificar filas, e monitorar estado de aplicacoes em tempo real.

Conexao via REDIS_URL: redis://localhost:6379. O agente pode inspecionar keys, checar TTLs, e ate limpar cache sob demanda.

Em 1 frase: Redis MCP = inspecionar e operar cache/filas Redis via agente.

3

๐ŸŒ HTTP/REST MCP

O HTTP MCP e um conector generico para qualquer API REST. Voce configura base URL e headers de auth, e o agente pode fazer GET, POST, PUT, DELETE em qualquer endpoint. E o canivete suico dos MCPs.

Cada operacao vira uma tool com parametros para path, query params, headers e body. Ideal para conectar servicos internos que nao tem um MCP dedicado.

Em 1 frase: HTTP MCP = conectar o agente a qualquer API REST com uma config.

4

โ—ˆ GraphQL MCP

Se sua API e GraphQL, este MCP permite executar queries e mutations diretamente. O agente usa introspection para entender o schema e construir queries adequadas automaticamente.

A configuracao precisa do endpoint GraphQL e opcionalmente headers de auth. O agente pode explorar o schema, listar types, e executar operacoes complexas com variables.

Em 1 frase: GraphQL MCP = queries e mutations GraphQL via agente, com schema introspection.

5

๐Ÿ”Œ Conectando a servicos reais

Conectar MCPs a servicos locais e facil. O desafio e conectar a ambientes reais: staging, producao. Patterns comuns: SSH tunnels para bancos remotos, env configs por projeto (settings.json local vs global), e connection pools para evitar sobrecarga.

Regra de ouro: nunca dรช acesso write a producao via MCP sem supervisao. Use read-only para queries e analise; write so em staging ou com approval flow.

Nunca write direto em prod

O agente pode executar DELETE ou DROP sem pensar duas vezes. Ambientes de producao devem ser read-only via MCP. Write so com approval ou em staging.

Em 1 frase: conectar a staging/prod = SSH tunnel + read-only + env por projeto.

6

๐Ÿ”’ Seguranca de credenciais

MCPs com acesso a DBs e APIs precisam de credenciais: connection strings, tokens, passwords. Essas credenciais ficam no settings.json ou em variaveis de ambiente. O risco: se o settings.json for commitado no git, as credenciais vazam.

Best practices: (1) use env no settings.json em vez de hardcode nos args, (2) adicione .claude/settings.json ao .gitignore, (3) para times, use um secret manager e referencie variaveis do shell.

.gitignore
# Nunca commitar settings com credenciais
.claude/settings.json
.env
.env.local

Em 1 frase: credenciais em env vars + gitignore + secret manager = seguranca basica.

๐Ÿงพ Resumo do Modulo

โœ“
PostgreSQL, Redis, REST, GraphQL โ€” MCPs para cada tipo de data source.
โœ“
Read-only em prod โ€” nunca dar write sem supervisao.
โœ“
Credenciais seguras โ€” env vars + gitignore + secret manager.

Proximo modulo:

3.5 โ€” Criando seu Proprio MCP Server: do zero ao deploy.