MCP personal

​

Elige la credencial adecuada

​

Crea un token y conecta

1. En Panel → Agent, abre Personal MCP.
2. Pon un nombre, selecciona los permisos necesarios y una caducidad de 1 a 365 días, 30 días por defecto.
3. Para models:invoke o utilities:invoke, vincula una clave API activa propia. Se mantienen sus restricciones de modelos, presupuesto y RPM. Consultar la cuenta no exige saldo positivo.
4. Al crearlo, copia el token mcp_user_ a la configuración secreta del cliente. No lo incluyas en código, chats ni registros. Revócalo en el mismo panel cuando ya no lo necesites.

​

Consulta las herramientas antes de llamarlas

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_capabilities",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_balance",
    "arguments": {
      "input": {}
    }
  }
}

​

Permisos

​

Escrituras, resultados y reintentos seguros

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "update_api_key",
    "arguments": {
      "input": {
        "key_id": "YOUR_KEY_ID",
        "rpmLimit": 60
      },
      "idempotencyKey": "set-key-rpm-20261106-01"
    }
  }
}

{
  "execution_id": "EXECUTION_ID",
  "replayed": false,
  "status": "completed",
  "data": {
    "balance": 100,
    "key": null
  }
}

​

Modelos y utilidades

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "chat_completion",
    "arguments": {
      "input": {
        "body": {
          "model": "PUBLIC_MODEL_ID",
          "messages": [
            {
              "role": "user",
              "content": "Hello"
            }
          ],
          "stream": false
        }
      },
      "idempotencyKey": "chat-example-20261106-01"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "run_utility",
    "arguments": {
      "input": {
        "utility": "image-hash",
        "parameters": {},
        "files": {
          "image": [
            "YOUR_FILE_ID"
          ]
        }
      },
      "idempotencyKey": "image-hash-example-01"
    }
  }
}

​

Subir y recuperar archivos

1. Llama a begin_upload con nombre, tipo MIME y tamaño exacto en bytes; máximo 250 MiB.
2. Llama a upload_chunk con index desde cero y data Base64. Cada bloque decodificado admite 1 MiB; los índices deben ser consecutivos desde cero.
3. Llama a finish_upload con file_id y SHA-256 opcional en minúsculas. Espera status: ready.
4. Pasa el ID a una herramienta compatible. get_artifact devuelve metadatos o bytes Base64 si indicas offset. Sigue next_offset hasta null. El enlace exige iniciar sesión como propietario.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "begin_upload",
    "arguments": {
      "input": {
        "name": "example.png",
        "mime_type": "image/png",
        "size": 12345
      },
      "idempotencyKey": "upload-example-begin-01"
    }
  }
}

• upload_media: máximo 20 archivos / 250 MiB en total.
• upload_image: un archivo de hasta 50 MiB.
• edit_image: máximo 20 archivos entre todos los campos, incluido como máximo un mask; 50 MiB por archivo / 100 MiB en total. También se aplican los límites por array del esquema.
• run_utility: aplica los límites de cantidad, tamaño individual y total de get_utility_schema, con un máximo absoluto de 250 MiB en total, aunque el catálogo permita más.

​

Confirmación web y pagos

• Secreto de clave: start_reveal_key_action → usuario aprueba confirmation_url → reveal_api_key con el id de la acción como action_id. La aprobación se vincula a esa clave y credencial, caduca 15 minutos después de crear la acción y se usa una sola vez. create_api_key solo devuelve metadatos.
• Cancelar suscripción: cancel_subscription inicia la confirmación. El usuario la ejecuta en la web. Comprueba get_account_action y la suscripción antes de informar que terminó.
• Contraseña/eliminación: start_account_action con password_change o delete_account. El usuario introduce códigos y contraseñas en la web, nunca en el asistente. Eliminar revoca el acceso y cierra la sesión; no sigas consultando MCP después.
• Pago: list_billing_products → create_checkout → usuario paga → get_payment_status. Un enlace no prueba el pago.
• Mensajes reales: resend_invoice y test_credit_alert envían correo o webhook. Úsalos solo por solicitud expresa.

​

Gestiona errores sin duplicar trabajo

{
  "isError": true,
  "structuredContent": {
    "error": {
      "code": "execution_pending",
      "message": "The original execution is pending; inspect its receipt before retrying",
      "status": 409,
      "execution_id": "EXECUTION_ID"
    }
  }
}

​

Primeros pasos de solo lectura

• Gasto: get_balance → summarize_usage → solicitudes individuales con list_usage.
• Fallo: diagnose_request con task_id; revisa error y reembolso antes de otra llamada al modelo.
• Integración: list_models → get_model_schema → get_api_guide, sin ejecutar modelos.
• Seguridad: list_api_keys → get_api_key → list_login_records.