Cómo conectar Oracle NetSuite a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Oracle NetSuite, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Oracle NetSuite + Cursor

Deja que tu IA trabaje con Oracle NetSuite: ejecuta consultas SuiteQL de solo lectura sobre clientes, proveedores, artículos, transacciones y el libro mayor, lee clientes, proveedores, empleados, artículos, pedidos de venta, facturas, órdenes de compra, facturas de proveedores y asientos contables con sus líneas, consulta tipos de registro y campos, y crea clientes y pedidos de venta. Inicio de sesión con OAuth 2.0 de NetSuite, en una cuenta de producción o de sandbox.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

NETSUITE_ACCOUNT_ID, NETSUITE_CLIENT_ID, NETSUITE_CLIENT_SECRET

Paso 1 — Obtener credenciales

Un administrador lo configura una sola vez, en unos 20 minutos.

1. Activa las funciones: Setup → Company → Enable Features. En la subpestaña SuiteCloud, marca REST Web Services y, en Manage Authentication, OAuth 2.0. En la subpestaña Analytics, marca SuiteAnalytics Workbook, de donde lee SuiteQL. Guarda.
2. Crea un rol para la IA: Setup → Users/Roles → Manage Roles → New. Añade los permisos REST Web Services (Full) y Log in using OAuth 2.0 Access Tokens (Full), View en las listas y transacciones que la IA puede leer (clientes, proveedores, artículos, empleados, cuentas, pedidos de venta, facturas, órdenes de compra, facturas de proveedores, asientos contables y Find Transaction) y Create donde puede escribir (clientes, pedidos de venta). Asigna el rol al usuario que va a iniciar sesión. Un rol dedicado es más seguro que Administrator: la IA solo ve lo que el rol permite.
3. Crea el registro de integración: Setup → Integration → Manage Integrations → New. Pon el estado en Enabled, desmarca Token-Based Authentication y TBA: Authorization Flow, marca Authorization Code Grant en OAuth 2.0, deja Public Client sin marcar, introduce el URI de redirección https://cloud.anythingmcp.com/api/mcp-oauth/callback (si alojas AnythingMCP tú mismo: <your AnythingMCP URL>/api/mcp-oauth/callback) y marca el scope REST Web Services. Al guardar, NetSuite muestra el Client ID y el Client Secret una sola vez, al final de la página. Pégalos en NETSUITE_CLIENT_ID y NETSUITE_CLIENT_SECRET.
4. Account ID: Setup → Company → Company Information. NETSUITE_ACCOUNT_ID lo espera tal como aparece en la dirección web de NetSuite: en minúsculas y con un guion en lugar del guion bajo, así que 1234567_SB1 pasa a ser 1234567-sb1. Para un sandbox, crea el registro de integración en el propio sandbox.
5. Instala el conector, haz clic en Authorize with Provider, inicia sesión en NetSuite y elige el rol del paso 2.
6. Ejecuta netsuite_list_record_types para comprobar la conexión y después una primera consulta como SELECT id, companyname FROM customer con netsuite_suiteql_query.

Vuelve a autorizar una vez por semana: NetSuite mantiene válido durante siete días el refresh token de este tipo de integración y no lo renueva, así que haz clic en Authorize with Provider al menos una vez por semana. Mientras tanto, los access tokens se renuevan automáticamente. Desactivar el registro de integración, el rol o el usuario corta el acceso al instante.

SuiteQL hace el trabajo pesado: netsuite_suiteql_query ejecuta una consulta SQL de solo lectura sobre los datos analíticos de NetSuite: clientes, proveedores, artículos, cuentas, subsidiarias y transacciones con sus líneas e importes contabilizados. Así responde la IA a preguntas como las facturas pendientes por cliente, las ventas por artículo o el gasto por proveedor. Los resultados llegan en páginas de hasta 1.000 filas y una consulta devuelve como máximo 100.000 filas en total, por lo que las preguntas amplias se responden con totales en lugar de filas sueltas. Las filas que el rol no puede ver se omiten sin error, así que una respuesta vacía puede deberse a un permiso que falta.

Registros: herramientas dedicadas leen clientes, proveedores, empleados, artículos, pedidos de venta, facturas, órdenes de compra, facturas de proveedores y asientos contables con sus líneas, y netsuite_get_record lee cualquier otro tipo de registro. netsuite_describe_record_type enumera todos los campos de un tipo de registro, incluidos los personalizados.

Escrituras solo tras confirmar: netsuite_create_customer crea un cliente cuando lo confirmas. netsuite_create_sales_order (que crea el pedido como Pending Approval, para que no se envíe nada antes de que alguien lo apruebe) y netsuite_update_record están desactivadas al instalar; actívalas una por una si las necesitas. Los cambios en transacciones contabilizadas afectan a la contabilidad.

Errores frecuentes: INVALID_LOGIN significa que la autorización semanal caducó o que se desactivó la integración, el rol o el usuario: vuelve a autorizar. 403 o INSUFFICIENT_PERMISSION: al rol le falta un permiso. CONCURRENCY_LIMIT_EXCEEDED: demasiadas solicitudes en paralelo en la cuenta, espera y vuelve a intentarlo. Un host desconocido significa que NETSUITE_ACCOUNT_ID no está escrito con el formato de la dirección web.

El conector inicia sesión solo con OAuth 2.0; Token-Based Authentication (TBA) no es compatible. No elimina registros, no ejecuta búsquedas guardadas ni informes, no llama a RESTlets y no usa el file cabinet.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Oracle NetSuite.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué clientes tienen facturas pendientes de más de 60 días y cuánto debe cada uno?"
• "Muéstrame las ventas del último trimestre por artículo, los 20 primeros por importe."
• "¿Cuánto hemos gastado con cada proveedor este año, según las facturas de proveedores?"
• "Crea un cliente para Harbor Supplies Ltd. en la subsidiaria del Reino Unido y muéstrame los datos antes de guardar."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT