@iadev/mcp-server

MCP Server para iadev.dev — conecte qualquer IA ao seu projeto.

Permite que VS Code Copilot, Cursor, Windsurf, Claude Desktop e qualquer plataforma compatível com MCP operem diretamente no seu banco — tabelas, SQL, usuários — sem sair do editor.

Instalação rápida

Não precisa instalar globalmente. Use npx direto:

npx -y github:iadevhub/iadev-mcp-server

Configuração

VS Code — GitHub Copilot

Criar arquivo .vscode/mcp.json na raiz do projeto:

{
  "servers": {
    "iadev": {
      "command": "npx",
      "args": ["-y", "github:iadevhub/iadev-mcp-server"],
      "env": {
        "IADEV_URL": "https://iadev.dev",
        "IADEV_PROJECT": "SEU_SLUG",
        "IADEV_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Cursor

Criar arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "iadev": {
      "command": "npx",
      "args": ["-y", "github:iadevhub/iadev-mcp-server"],
      "env": {
        "IADEV_URL": "https://iadev.dev",
        "IADEV_PROJECT": "SEU_SLUG",
        "IADEV_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Windsurf

Abrir Settings → MCP ou criar ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "iadev": {
      "command": "npx",
      "args": ["-y", "github:iadevhub/iadev-mcp-server"],
      "env": {
        "IADEV_URL": "https://iadev.dev",
        "IADEV_PROJECT": "SEU_SLUG",
        "IADEV_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Claude Desktop

Editar claude_desktop_config.json (menu Settings → Developer):

{
  "mcpServers": {
    "iadev": {
      "command": "npx",
      "args": ["-y", "github:iadevhub/iadev-mcp-server"],
      "env": {
        "IADEV_URL": "https://iadev.dev",
        "IADEV_PROJECT": "SEU_SLUG",
        "IADEV_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Variáveis de ambiente

Variável	Obrigatória	Descrição
`IADEV_URL`	Sim	URL da API (padrão: `https://iadev.dev`)
`IADEV_PROJECT`	Sim	Slug do projeto
`IADEV_API_KEY`	Recomendada	API Key para auto-autenticação

Tools disponíveis (15)

Tool	Descrição
`login`	Autenticar como admin do projeto
`get_service_token`	Trocar API Key por JWT técnico
`get_project_info`	Informações do projeto
`list_tables`	Listar tabelas do schema
`get_columns`	Listar colunas de uma tabela
`query_data`	Buscar dados paginados
`execute_sql`	Executar SQL (DDL/DML)
`list_users`	Listar usuários do projeto
`create_user`	Criar usuário
`update_user`	Atualizar usuário
`create_project`	Criar novo projeto IAdev
`list_my_projects`	Listar meus projetos
`provision_project`	Provisionar com infra (super_admin)
`publish_project`	Conectar repo + deploy
`deploy_status`	Status do deployment

Segurança

A IADEV_API_KEY é usada para auto-autenticação. O token gerado tem papel service e acessa apenas o schema do seu projeto. Nunca compartilhe a API Key em repositórios públicos — use variáveis de ambiente ou .env.

Licença

MIT