# Conectar tu IDE

El servidor MCP de Notiq vive en:

```
https://notiq.online/api/mcp
```

Habla Streamable HTTP y soporta tanto OAuth (el cliente te manda a una pantalla de
consentimiento y listo) como una API key en la cabecera.

## Claude Code

```bash
claude mcp add --transport http notiq https://notiq.online/api/mcp
```

La primera vez te abrirá el navegador para que autorices. Si prefieres una API key:

```bash
claude mcp add --transport http notiq https://notiq.online/api/mcp \
  --header "Authorization: Bearer ntq_sk_tu_key"
```

## Cursor

En `.cursor/mcp.json` (del proyecto) o `~/.cursor/mcp.json` (global):

```json
{
  "mcpServers": {
    "notiq": {
      "url": "https://notiq.online/api/mcp",
      "headers": { "Authorization": "Bearer ntq_sk_tu_key" }
    }
  }
}
```

## VS Code

En `.vscode/mcp.json` — ojo, la clave raíz es `servers`, no `mcpServers`:

```json
{
  "servers": {
    "notiq": {
      "type": "http",
      "url": "https://notiq.online/api/mcp"
    }
  }
}
```

## Claude.ai

Ajustes → Conectores → Añadir conector personalizado, y pega la URL del servidor.
El flujo de OAuth se dispara solo.

## Qué puede hacer

Una vez conectado, tu editor tiene estas herramientas:

**Leer** — `list_teams`, `get_team`, `list_members`, `list_sprints`, `get_sprint`,
`list_activities`, `get_activity`, `list_comments`, `search_documents`,
`get_document`, `list_skills`, `get_usage`

**Escribir** — `create_sprint`, `update_sprint`, `create_activity`,
`update_activity`, `comment_activity`, `create_document`

**IA** — `ask_team` (pregunta sobre los documentos del equipo),
`plan_sprint_from_text` (extrae tareas de un texto libre)

Solo aparecen las que tu credencial permite: una key de solo lectura no le enseña
al modelo herramientas de escritura que iba a rechazar.

## Cosas que puedes pedirle

> Crea las actividades del sprint a partir de las notas de la reunión que acabo de
> escribir en `notas.md`.

> ¿Qué actividades tengo asignadas y cuáles van tarde?

> Mueve a revisión la tarea del login y coméntale al equipo que ya está lista.