# @iadev/mcp-server

MCP Server para [iadev.dev](https://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:

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

## Configuração

### VS Code — GitHub Copilot

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

```json
{
  "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`:

```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`:

```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`):

```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"
      }
    }
  }
}
```

## 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