MCP

Agente pede, MCP client empacota, server externo executa, API real responde. A volta tras dados estruturados, prontos para o agente raciocinar.

{
  "mcpServers": {
    // GitHub: PRs, issues, comentarios
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GH_TOKEN}"
      }
    },

    // Filesystem: acessa pastas fora do projeto
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/Documents",
        "/Users/me/Downloads"
      ]
    },

    // Postgres: consulta o banco direto
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${env:DATABASE_URL}"
      }
    }
  }
}

O agente termina a feature, abre o PR, escreve a descricao, marca o reviewer. Tudo sem voce sair do terminal. Sem alt-tab pro browser.

# Listagem (parcial) das tools do server

mcp__github__create_pull_request
mcp__github__list_issues
mcp__github__create_issue_comment
mcp__github__get_file_contents
mcp__github__search_repositories
mcp__github__create_or_update_file
mcp__github__merge_pull_request
mcp__github__add_issue_comment

# Token via env, nunca commitado
GITHUB_PERSONAL_ACCESS_TOKEN="$GH_TOKEN"

Por padrao o Claude Code so ve a pasta onde voce abriu a sessao. O filesystem MCP libera outras pastas, sob seu controle, com pastas que voce escolhe explicitamente.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "~/Documents/clientes",
        "~/Downloads/relatorios",
        "/var/log/app"
      ]
    }
  }
}

# Tools disponiveis no agente:
#   mcp__filesystem__read_file
#   mcp__filesystem__write_file
#   mcp__filesystem__list_directory
#   mcp__filesystem__search_files

Sem abrir o pgAdmin, sem cliente SQL aberto. O agente le o schema, monta a query, traz o resultado e ja explica em portugues. Bom para debug em producao.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres"
      ],
      "env": {
        "DATABASE_URL": "${env:DATABASE_URL}"
      }
    }
  }
}

# Tools expostas:
#   mcp__postgres__query
#   mcp__postgres__list_tables
#   mcp__postgres__describe_table

O agente terminou o deploy, rodou a migration, fechou a issue. Em vez de voce escrever o aviso, ele posta no canal certo, com o link certo. Comunicacao on-the-fly.

mcp__slack__post_message
mcp__slack__reply_to_thread
mcp__slack__list_channels
mcp__slack__get_channel_history
mcp__slack__add_reaction
mcp__slack__get_user_profile

# Combo com hooks:
# Stop hook -> agente posta resumo
# do que fez na sessao no #dev-bot

# Combo com command:
# /notify desploy ok -> post no #ops

O agente abre o Chromium de verdade, navega, clica, preenche, tira screenshot. Util para testar fluxos visuais, scrapear paginas com login ou simular o usuario.

mcp__puppeteer__navigate
mcp__puppeteer__screenshot
mcp__puppeteer__click
mcp__puppeteer__fill
mcp__puppeteer__evaluate
mcp__puppeteer__select

# Caso classico:
# "Verifique se o checkout
# funciona em staging e me
# traga uma screenshot de
# cada passo"

# O agente navega, clica,
# preenche cartao de teste,
# confirma e te entrega o
# relatorio visual.