Instructivo: Conectar Softr con Claude Desktop (MCP)

Este instructivo está diseñado para que cualquier miembro del equipo pueda configurar la integración entre Claude Desktop y nuestra plataforma de Softr (app.aeroidea.net).

🛠️ Requisitos Previos

1. Tener instalado Claude Desktop en tu computadora (Windows).
2. Tener instalado Node.js (puedes descargarlo desde nodejs.org).
3. Tener una cuenta activa en Softr con permisos para generar una API Key.

🚀 Paso 1: Generar la API Key de Softr

1. Inicia sesión en Softr.app.
2. Entra al panel de administración de nuestra aplicación (app.aeroidea.net).
3. En el menú lateral izquierdo, dirígete a Settings (Configuración) > Integrations (o Personal Access Tokens).
4. Haz clic en «Generate API Key».
5. Copia y guarda ese código en un lugar seguro (se verá parecido a pat_Ludx...).

📁 Paso 2: Crear el Conector Local

Necesitamos descargar e instalar el «puente» que comunicará a Claude con Softr.

1. Abre el Símbolo del Sistema (CMD) o PowerShell en tu computadora.
2. Crea una carpeta para guardar el conector ejecutando estos comandos uno por uno (presiona Enter después de cada línea):
   mkdir "C:\softr-mcp"
cd "C:\softr-mcp"
npm init -y
npm install @modelcontextprotocol/sdk axios
3. Ahora, abre el bloc de notas (Notepad), copia el siguiente código y guárdalo dentro de la carpeta C:softr-mcp con el nombre exacto de index.js.

#!/usr/bin/env node
const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
const axios = require("axios");

const API_KEY = process.env.SOFTR_API_KEY;
const DOMAIN = process.env.SOFTR_DOMAIN;

if (!API_KEY || !DOMAIN) {
    console.error("Missing SOFTR_API_KEY or SOFTR_DOMAIN environment variables");
    process.exit(1);
}

const server = new Server(
    { name: "softr-mcp", version: "1.0.0" },
    { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
        tools: [
            {
                name: "softr_list_users",
                description: "List users from the Softr application",
                inputSchema: {
                    type: "object",
                    properties: {
                        limit: { type: "number", description: "Maximum number of users to return" }
                    }
                }
            }
        ]
    };
});

server.setRequestHandler(CallToolRequestSchema, async (request) => {
    if (request.params.name === "softr_list_users") {
        try {
            const response = await axios.get("https://studio-api.softr.io/v1/api/users", {
                headers: {
                    "Softr-Api-Key": API_KEY,
                    "Softr-Domain": DOMAIN
                }
            });
            return {
                content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
            };
        } catch (error) {
            return {
                content: [{ type: "text", text: `Error fetching Softr users: ${error.message}` }],
                isError: true
            };
        }
    }
    throw new Error("Tool not found");
});

const transport = new StdioServerTransport();
server.connect(transport).catch(console.error);

⚙️ Paso 3: Conectar a Claude Desktop

1. Presiona las teclas Windows + R en tu teclado.
2. Escribe %APPDATA%Claude y presiona Enter. Se abrirá una carpeta oculta.
3. Busca el archivo llamado claude_desktop_config.json. Si no existe, créalo con el bloc de notas.
4. Ábrelo con el bloc de notas y asegúrate de que contenga el siguiente código. REEMPLAZA el texto «TU_API_KEY_AQUI» por la clave que sacaste en el Paso 1.

{
  "mcpServers": {
    "softr": {
      "command": "node",
      "args": [
        "C:\\softr-mcp\\index.js"
      ],
      "env": {
        "SOFTR_API_KEY": "TU_API_KEY_AQUI",
        "SOFTR_DOMAIN": "app.aeroidea.net"
      }
    }
  }
}

✅ Paso 4: Reiniciar y Probar

1. Cierra completamente Claude Desktop (haz clic derecho en el ícono de la barra de tareas abajo junto al reloj y dale a «Salir»).
2. Vuelve a abrir Claude Desktop.
3. Al abrir cualquier chat, verás un ícono con forma de enchufe o martillo en la esquina inferior derecha indicando que se conectó.
4. Puedes probar escribiéndole a Claude: «Lista los usuarios que tenemos en Softr».