Automação Neon

Automatize seus fluxos de trabalho do Neon serverless Postgres -- liste projetos e branches, inspecione bancos de dados, recupere URIs de conexão, gerencie roles e integre operações de banco de dados Neon em pipelines entre aplicativos.

Documentação do Toolkit: composio.dev/toolkits/neon

Configuração

1. Adicione o servidor Composio MCP ao seu cliente: https://rube.app/mcp
2. Conecte sua conta Neon quando solicitado (autenticação por chave de API)
3. Comece a usar os fluxos de trabalho abaixo

Fluxos de Trabalho Principais

1. Listar Projetos

Use NEON_RETRIEVE_PROJECTS_LIST para descobrir todos os projetos associados ao usuário autenticado.

Tool: NEON_RETRIEVE_PROJECTS_LIST
Inputs:
  - org_id: string (REQUIRED when using a personal API key)
  - limit: integer (1-400, default 10)
  - cursor: string (pagination cursor from previous response)
  - search: string (search by project name or ID, supports partial match)
  - timeout: integer (milliseconds; returns partial results on timeout)

Importante: Ao usar uma chave de API pessoal, org_id é necessário. Recupere-a primeiro via NEON_GET_USER_ORGANIZATIONS.

2. Obter Detalhes do Projeto

Use NEON_ACCESS_PROJECT_DETAILS_BY_ID para inspecionar a configuração do projeto, informações do proprietário e métricas de consumo.

Tool: NEON_ACCESS_PROJECT_DETAILS_BY_ID
Inputs:
  - project_id: string (required) -- format: "adjective-noun-number", e.g., "dry-smoke-26258271"

3. Listar Branches de um Projeto

Use NEON_GET_BRANCHES_FOR_PROJECT para enumerar branches (estágios de desenvolvimento) dentro de um projeto.

Tool: NEON_GET_BRANCHES_FOR_PROJECT
Inputs:
  - project_id: string (required)
  - search: string (optional, search by branch name or ID)

4. Listar Bancos de Dados em um Branch

Use NEON_FETCH_DATABASE_FOR_BRANCH para inventariar bancos de dados dentro de um projeto e branch específicos.

Tool: NEON_FETCH_DATABASE_FOR_BRANCH
Inputs:
  - project_id: string (required)
  - branch_id: string (required)

5. Obter URI de Conexão

Use NEON_GET_PROJECT_CONNECTION_URI para obter uma string de conexão Postgres para um projeto/branch/banco de dados.

Tool: NEON_GET_PROJECT_CONNECTION_URI
Inputs:
  - project_id: string (required)
  - database_name: string (required) -- e.g., "neondb"
  - role_name: string (required) -- e.g., "neondb_owner"
  - branch_id: string (optional, defaults to project default branch)
  - endpoint_id: string (optional, defaults to read-write endpoint)
  - pooled: boolean (optional, adds -pooler for connection pooling)

Segurança: A URI retornada inclui credenciais. Trate-a como um segredo -- não a registre em log nem a compartilhe.

6. Inspecionar Detalhes e Roles do Banco de Dados

Use NEON_RETRIEVE_BRANCH_DATABASE_DETAILS para verificar um banco de dados antes de conectar, e NEON_GET_BRANCH_ROLES_FOR_PROJECT para listar roles disponíveis.

Tool: NEON_RETRIEVE_BRANCH_DATABASE_DETAILS
Inputs:
  - project_id: string (required)
  - branch_id: string (required)
  - database_name: string (required)

Tool: NEON_GET_BRANCH_ROLES_FOR_PROJECT
Inputs:
  - project_id: string (required)
  - branch_id: string (required)

Armadilhas Conhecidas

Referência Rápida

…