ThoughtSpot SpotterCode MCP Server

SpotterCode

Para el índice completo de documentación, consulta llms.txt

Fuente: https://developers.thoughtspot.com/docs/SpotterCode

SpotterCode

SpotterCode de ThoughtSpot es un asistente de codificación impulsado por IA que agiliza y acelera el proceso de incrustar contenido de ThoughtSpot e integrar las API REST de ThoughtSpot. SpotterCode está disponible en tu IDE, en el Visual Embed Playground y en el sitio de documentación para desarrolladores de ThoughtSpot.

¿Qué es SpotterCode?

SpotterCode se conecta a un servidor MCP alojado por ThoughtSpot y proporciona capacidades de codificación y documentación asistidas por IA en múltiples superficies. Brinda a los desarrolladores acceso directo a los SDK de ThoughtSpot, documentación de API REST, ejemplos de código y guías para desarrolladores, ya sea que trabajen en un IDE nativo de IA, experimenten en el Visual Embed Playground o naveguen por el sitio de documentación para desarrolladores de ThoughtSpot.

SpotterCode está disponible en las siguientes superficies:

Superficie	Descripción
IDE

|

Conecta tu IDE nativo de IA al servidor MCP de SpotterCode. El agente de IA en tu IDE puede generar código de incrustación, ejecutar flujos de trabajo autenticados de API de ThoughtSpot y consultar documentación sin salir de tu entorno de desarrollo. SpotterCode admite los siguientes IDE:

• Cursor AI

• Visual Studio Code con GitHub Copilot

• Claude Code

Para obtener más información, consulta Integrar SpotterCode con tu IDE.

| | Visual Embed Playground

|

Un asistente de codificación con IA integrado en la página de Playground de tu instancia de ThoughtSpot. SpotterCode aparece como un panel deslizante y genera código de incrustación para el componente que estás configurando, utilizando indicaciones de inicio rápido o instrucciones personalizadas. Consulta SpotterCode en el Visual Embed Playground.

| | Sitio de documentación para desarrolladores

|

El asistente de chat de SpotterCode está disponible en el sitio de documentación para desarrolladores de ThoughtSpot (link:https://developers.thoughtspot.com/docs). Puedes usarlo para hacer preguntas sobre incrustación, API REST y configuración de SDK sin salir de la página de documentación. Esta superficie utiliza el endpoint /mcp/docs no autenticado y no requiere una instancia de ThoughtSpot.

|

¿Quién debería usar SpotterCode?

SpotterCode está diseñado para desarrolladores y equipos técnicos que incrustan contenido de ThoughtSpot o integran las API REST de ThoughtSpot en sus aplicaciones.

• Usuarios de IDE: Desarrolladores que usan IDE nativos de IA como Cursor, Visual Studio Code con GitHub Copilot o Claude Code que desean generación de código contextual y ejecución directa de API desde su entorno de desarrollo.

• Usuarios de Playground: Desarrolladores que exploran opciones de incrustación en el Visual Embed Playground y desean generar e iterar sobre código de incrustación rápidamente sin escribir código repetitivo manualmente.

• Visitantes del sitio de documentación: Desarrolladores que leen la documentación para desarrolladores de ThoughtSpot y desean hacer preguntas sobre incrustación, API o configuración de SDK en contexto.

SpotterCode para usuarios de IDE

SpotterCode es útil en cada etapa de un proyecto de ThoughtSpot incrustado:

• Configuración de un nuevo proyecto incrustado
  Usa el endpoint /mcp autenticado para que el agente del IDE pueda configurar tu instancia de ThoughtSpot directamente. Puedes generar una clave secreta de autenticación de confianza, agregar tu dominio de aplicación a las listas de permitidos de CORS y CSP, y recuperar IDs de objetos de Liveboard y Answer, todo sin salir de tu IDE.

• Escritura y revisión de código de incrustación
  SpotterCode brinda a tu agente de IDE acceso directo a la documentación del Visual Embed SDK y la API REST, ejemplos de código y guías para desarrolladores. El agente puede generar código de incrustación contextual adaptado a la estructura de tu proyecto y proporcionar acceso directo a la referencia del SDK.

• Integración de flujos de trabajo de API REST
  Accede a especificaciones actualizadas de API REST, formatos de solicitud y respuesta, flujos de autenticación y referencias de SDK de TypeScript y Java para acelerar la integración de API.

• Consulta de documentación
  SpotterCode capacita a tu IDE con capacidades de consulta de documentación y proporciona acceso directo a información autorizada sobre cómo incrustar ThoughtSpot o integrar flujos de trabajo de API REST en tus proyectos de desarrollo.

NOTA: SpotterCode es una herramienta de aceleración diseñada para ayudar a los desarrolladores a agilizar el proceso de integración de ThoughtSpot en sus proyectos. No reemplaza al Visual Embed SDK ni al conocimiento fundamental requerido para la incrustación o la integración de aplicaciones.

Endpoints del servidor MCP

SpotterCode es una herramienta complementaria disponible con las ofertas de ThoughtSpot Analytics y ThoughtSpot Embedded. Si tienes una licencia de ThoughtSpot Analytics con una suscripción activa de ThoughtSpot Embedded, puedes integrar SpotterCode usando la URL del servidor MCP de SpotterCode en tu aplicación de codificación.

ThoughtSpot proporciona los siguientes endpoints de servidor MCP para SpotterCode:

Endpoint	URL	Herramientas disponibles
Endpoint autenticado
(/mcp)

|

https://spottercode.thoughtspot.app/mcp
El endpoint de SpotterCode de capacidad completa. Requiere autenticación con una instancia de ThoughtSpot. Puedes usar este endpoint MCP para realizar operaciones de usuario autenticadas en tu instancia de ThoughtSpot a través de las API REST públicas.

|

get-rest-api-reference
get-developer-docs-reference
execute-thoughtspot-code

| | Endpoint de documentación
(/mcp/docs)

|

https://spottercode.thoughtspot.app/mcp/docs
Este endpoint incluye solo habilidades de recuperación de documentación y no requiere autenticación. Usa este endpoint si solo necesitas que el agente de IA consulte la documentación para desarrolladores de ThoughtSpot y la referencia de API REST, sin conectarte a una instancia activa de ThoughtSpot.

|

get-rest-api-reference
get-developer-docs-reference

|

Herramientas MCP compatibles

SpotterCode proporciona las siguientes habilidades al agente de IA en tu IDE. Las habilidades autenticadas requieren una sesión válida de ThoughtSpot establecida a través del flujo de autenticación de SpotterCode.

• get-rest-api-reference
  Proporciona especificaciones de API REST, endpoints, formatos de solicitud/respuesta, flujos de autenticación, operaciones CRUD y SDK para TypeScript y Java.

• get-developer-docs-reference
  Proporciona acceso a documentación sobre incrustación, personalización de interfaz de usuario, implementación, seguridad y mejores prácticas.

• execute-thoughtspot-code
  Ejecuta flujos de trabajo autenticados de API de ThoughtSpot directamente desde tu agente de IDE. Esta habilidad permite que tu agente de IDE realice operaciones comunes que se pueden hacer a través de las API REST públicas.

Cómo elegir el endpoint correcto

Usa la siguiente guía para decidir qué endpoint configurar en tu IDE:

• Usa /mcp (autenticado) si:

  • Quieres que el agente de IA ejecute flujos de trabajo de API de ThoughtSpot desde tu IDE, por ejemplo, para generar una clave secreta de autenticación de confianza, configurar tu dominio de aplicación en las listas de permitidos de CORS/CSP o recuperar IDs de objetos de Liveboard y Answer de tu instancia.

  • Quieres que tu IDE use el conjunto completo de habilidades de SpotterCode, incluido run-ts-workflow.

  • Estás creando o configurando una aplicación incrustada de ThoughtSpot y deseas asistencia de configuración de extremo a extremo sin salir del IDE.

• Usa /mcp/docs (no autenticado) si:

  • Solo necesitas que el agente de IA consulte documentación, material de referencia de API REST y ejemplos de código.

  • Estás trabajando en un entorno donde conectarse a una instancia de ThoughtSpot no es apropiado. Por ejemplo, un entorno de CI compartido, una estación de trabajo de desarrollador de solo lectura o una configuración de demostración.

  • No tienes una suscripción de ThoughtSpot Embedded ni credenciales de instancia disponibles.

NOTA: Los pasos de configuración del IDE en esta guía usan el endpoint /mcp autenticado de forma predeterminada. Si deseas usar el endpoint /mcp/docs no autenticado, reemplaza la URL del endpoint en el fragmento de configuración correspondiente antes de guardar. Todos los demás pasos de configuración permanecen iguales.

Seguridad y gobernanza de datos

SpotterCode está diseñado para operar dentro del modelo de seguridad y gobernanza existente de ThoughtSpot. La siguiente tabla muestra qué datos envía SpotterCode a su servidor MCP alojado y cómo se aplican tus controles de acceso de ThoughtSpot en todas las superficies de SpotterCode.

Superficie	Autenticación requerida	RLS/CLS aplicado	Se conecta a la instancia de ThoughtSpot	Datos enviados al servidor MCP
IDE

|

Sí. OAuth/SAML o token de portador

|

Sí

|

Sí

|

Consultas del usuario, solicitudes de llamadas a herramientas del agente del IDE y el contexto de autenticación requerido para ejecutar código en nombre del usuario. SpotterCode no envía tu código fuente, contenido de archivos locales ni estructura de proyecto al servidor MCP.

| | Visual Embed Playground

|

Sí. Requiere una sesión activa de ThoughtSpot.

|

Sí

|

Sí

|

Consultas del usuario enviadas dentro de la sesión de Playground. El Playground opera dentro de tu sesión autenticada de ThoughtSpot. No se transmiten credenciales adicionales por separado.

| | Sitio de documentación para desarrolladores

|

No

|

N/A

|

No

|

Consultas del usuario y contexto de página. No se requiere autenticación ni datos de instancia. La superficie del sitio de documentación es de acceso público.

| | | | | | |

Controles de acceso y gobernanza de ThoughtSpot

SpotterCode no omite ni modifica el modelo de control de acceso existente de ThoughtSpot. Cuando SpotterCode ejecuta operaciones contra tu instancia de ThoughtSpot a través de la herramienta execute-thoughtspot-code, actúa como el usuario autenticado cuyo token de sesión está en uso y puede realizar operaciones de lectura y escritura permitidas para ese usuario. Las siguientes funciones de seguridad de ThoughtSpot permanecen vigentes:

Debido a que el código se ejecuta como el usuario autenticado, las operaciones de escritura, como crear, actualizar, eliminar y compartir, generan las mismas entradas de registro de auditoría que las llamadas equivalentes a la API REST realizadas directamente por ese usuario. Para obtener detalles sobre los eventos capturados y cómo recuperarlos, consulta Registros de auditoría y API de registros de auditoría.

NOTA: SpotterCode realiza operaciones como el usuario autenticado. Otorga acceso a SpotterCode solo a cuentas con los permisos mínimos requeridos para el caso de uso previsto.

Limitaciones

• Las respuestas de SpotterCode están determinadas por las funciones y parámetros actualmente compatibles con el Visual Embed SDK, la API REST y la documentación oficial para desarrolladores de ThoughtSpot. SpotterCode no puede generar código ni soluciones que dependan de funciones no compatibles o no documentadas.

• SpotterCode puede generar ejemplos de código para los casos de uso más comunes. Los escenarios que requieren personalización avanzada o flujos de trabajo altamente especializados pueden requerir intervención manual o codificación adicional más allá de lo que SpotterCode proporciona.

• SpotterCode no influye en cómo la función Spotter en tu incrustación de ThoughtSpot infiere el modelado semántico. SpotterCode no está diseñado para consultar modelos de datos ni interpretar definiciones como medidas y atributos en tus objetos de metadatos.

• El comportamiento del agente del IDE, incluida la selección de herramientas y el razonamiento, no está controlado por SpotterCode.

Próximos pasos

[

Integrar SpotterCode con tu IDE

Conecta tu entorno de desarrollo a SpotterCode y usa las habilidades de SpotterCode.

](../docs/integrate-SpotterCode)

[

Ver ejemplos de indicaciones y mejores prácticas

Aprende a usar SpotterCode en tu IDE para obtener los mejores resultados y explora indicaciones de ejemplo.

](../docs/spottercode-prompting-guide)