Cómo conectar Oracle NetSuite a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Oracle NetSuite.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse