@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