# Instalar el servidor MCP de SciFig

Conecta un asistente de IA a SciFig. URL del servidor: https://mcp.scifig.ai/mcp. Descripción general: https://scifig.ai/es/mcp. Referencia: https://scifig.ai/es/docs/api/mcp.

## Reglas para los agentes que realizan la instalación

- Instala SciFig solo si el usuario lo ha pedido; no lo añadas por iniciativa propia.
- Elige los pasos del cliente en el que te estás ejecutando. Si no puedes cambiar su configuración, muestra al usuario los pasos exactos.
- Nunca pidas la contraseña del usuario. Los clientes OAuth inician sesión en el navegador; para una clave API, pide al usuario que la cree en Ajustes → Desarrollador y que la pegue él mismo en la configuración.
- Para comprobar la conexión, llama a `get_credit_balance`: es gratis. No crees una figura solo para hacer una prueba.
- Informa únicamente de lo que has observado: las herramientas visibles y el resultado de `get_credit_balance`.

## Servidor MCP

URL del servidor: `https://mcp.scifig.ai/mcp`, Streamable HTTP. Los clientes compatibles con OAuth se conectan iniciando sesión en SciFig y autorizando el acceso; los que envían cabeceras pueden usar una clave API como `Authorization: Bearer sk_live_…`.

| Herramienta | Función |
| --- | --- |
| generate_figure | Crear una ilustración científica a partir de una descripción |
| edit_figure | Editar una imagen: instrucciones, opcionalmente una región enmascarada, fondo blanco, relación de aspecto, cambio de colores o sustitución de texto |
| detect_text | Detectar el texto de una imagen antes de sustituirlo |
| upscale_figure | Ampliar a 2K, 4K u 8K |
| convert_figure | Convertir a SVG, PNG, PDF, TIFF o PPTX |
| generate_chart | Crear un gráfico a partir de texto CSV o TSV o filas JSON, hasta 1 MB |
| edit_chart | Modificar la versión más reciente de un gráfico |
| generate_flowchart | Dibujar un diagrama de flujo en SVG, opcionalmente a partir de hasta 8 archivos adjuntos |
| edit_flowchart | Modificar la versión más reciente de un diagrama de flujo |
| get_job | Estado, créditos y enlaces de descarga de una tarea |
| list_figures | Tareas recientes |
| get_credit_balance | Saldo de créditos, plan y límites |

Las herramientas de creación esperan hasta 25 segundos. Si una tarea sigue ejecutándose, llama a `get_job` más tarde; volver a llamar a la herramienta de creación crea y cobra una tarea nueva. Los resultados incluyen cada enlace de descarga y, para gráficos y diagramas de flujo, el enlace que abre el resultado en el editor de SciFig.

Las herramientas de creación comprueban el ámbito `figures:generate` antes de descargar archivos adjuntos. Una conexión de solo lectura puede consultar tareas y créditos, pero no puede crear figuras.

## Conecta tu cliente

Claude, en claude.ai y Claude Desktop: Ajustes → Conectores → Añadir conector personalizado. Introduce la URL del servidor, inicia sesión en SciFig y permite el acceso.

ChatGPT: Ajustes → Aplicaciones → Avanzado → Modo de desarrollador. Crea una aplicación con la URL del servidor y autenticación OAuth.

Claude Code:

```bash
claude mcp add --transport http scifig https://mcp.scifig.ai/mcp
```

Codex (`~/.codex/config.toml`):

```toml
[mcp_servers.scifig]
url = "https://mcp.scifig.ai/mcp"
```

Cursor, en `~/.cursor/mcp.json`, con una clave API creada en Ajustes → Desarrollador:

```json
{
  "mcpServers": {
    "scifig": {
      "url": "https://mcp.scifig.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}
```

Los clientes sin OAuth pueden añadir la cabecera `Authorization: Bearer sk_live_…` con una clave API creada en Ajustes → Desarrollador.