ThoughtSpot SpotterCode MCP Server

SpotterCode

Para o índice completo da documentação, consulte llms.txt

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

SpotterCode

O SpotterCode da ThoughtSpot é um assistente de codificação com tecnologia de IA que agiliza e acelera o processo de incorporação de conteúdo da ThoughtSpot e integração das APIs REST da ThoughtSpot. O SpotterCode está disponível no seu IDE, no Visual Embed Playground e no site de documentação para desenvolvedores da ThoughtSpot.

O que é o SpotterCode?

O SpotterCode se conecta a um servidor MCP hospedado pela ThoughtSpot e oferece recursos de codificação assistida por IA e documentação em várias superfícies. Ele dá aos desenvolvedores acesso direto aos SDKs da ThoughtSpot, à documentação da API REST, a exemplos de código e a guias para desenvolvedores, estejam eles trabalhando em um IDE nativo de IA, experimentando no Visual Embed Playground ou navegando pelo site de documentação para desenvolvedores da ThoughtSpot.

O SpotterCode está disponível nas seguintes superfícies:

Superfície	Descrição
IDE

|

Conecta seu IDE nativo de IA ao servidor MCP do SpotterCode. O agente de IA no seu IDE pode gerar código de incorporação, executar fluxos de trabalho autenticados da API da ThoughtSpot e consultar documentação sem sair do seu ambiente de desenvolvimento. O SpotterCode oferece suporte aos seguintes IDEs:

• Cursor AI

• Visual Studio Code com GitHub Copilot

• Claude Code

Para obter mais informações, consulte Integrar o SpotterCode ao seu IDE.

| | Visual Embed Playground

|

Um assistente de codificação com IA integrado na página do Playground na sua instância da ThoughtSpot. O SpotterCode aparece como um painel deslizante e gera código de incorporação para o componente que você está configurando, usando prompts de início rápido ou instruções personalizadas. Consulte SpotterCode no Visual Embed Playground.

| | Site de documentação para desenvolvedores

|

O assistente de chat do SpotterCode está disponível no site de documentação para desenvolvedores da ThoughtSpot (link:https://developers.thoughtspot.com/docs). Você pode usá-lo para fazer perguntas sobre incorporação, APIs REST e configuração do SDK sem sair da página de documentação. Esta superfície usa o endpoint /mcp/docs não autenticado e não requer uma instância da ThoughtSpot.

|

Quem deve usar o SpotterCode?

O SpotterCode foi projetado para desenvolvedores e equipes técnicas que incorporam conteúdo da ThoughtSpot ou integram as APIs REST da ThoughtSpot em seus aplicativos.

• Usuários de IDE: Desenvolvedores que usam IDEs nativos de IA, como Cursor, Visual Studio Code com GitHub Copilot ou Claude Code, que desejam geração de código sensível ao contexto e execução direta de APIs a partir do seu ambiente de desenvolvimento.

• Usuários do Playground: Desenvolvedores que exploram opções de incorporação no Visual Embed Playground e desejam gerar e iterar rapidamente no código de incorporação sem escrever código boilerplate manualmente.

• Visitantes do site de documentação: Desenvolvedores que leem a documentação para desenvolvedores da ThoughtSpot e desejam fazer perguntas sobre incorporação, APIs ou configuração do SDK no contexto.

SpotterCode para usuários de IDE

O SpotterCode é útil em todas as etapas de um projeto incorporado da ThoughtSpot:

• Configurando um novo projeto incorporado
  Use o endpoint /mcp autenticado para que o agente do IDE possa configurar sua instância da ThoughtSpot diretamente. Você pode gerar uma chave secreta de autenticação confiável, adicionar o domínio do seu aplicativo às listas de permissões de CORS e CSP e recuperar IDs de objetos de Liveboard e Answer, tudo sem sair do seu IDE.

• Escrevendo e revisando código de incorporação
  O SpotterCode dá ao agente do seu IDE acesso direto à documentação do Visual Embed SDK e da API REST, exemplos de código e guias para desenvolvedores. O agente pode gerar código de incorporação sensível ao contexto, adaptado à estrutura do seu projeto, e fornecer acesso direto à referência do SDK.

• Integrando fluxos de trabalho da API REST
  Acesse especificações atualizadas da API REST, formatos de solicitação e resposta, fluxos de autenticação e referências dos SDKs TypeScript e Java para acelerar a integração de APIs.

• Consultando documentação
  O SpotterCode capacita seu IDE com recursos de consulta de documentação e fornece acesso direto a informações confiáveis sobre como incorporar a ThoughtSpot ou integrar fluxos de trabalho da API REST em seus projetos de desenvolvimento.

NOTA: O SpotterCode é uma ferramenta de aceleração projetada para ajudar desenvolvedores a agilizar o processo de integração da ThoughtSpot em seus projetos. Ele não substitui o Visual Embed SDK nem o conhecimento fundamental necessário para incorporação ou integração de aplicativos.

Endpoints do servidor MCP

O SpotterCode é uma ferramenta complementar disponível com as ofertas ThoughtSpot Analytics e ThoughtSpot Embedded. Se você tiver uma licença do ThoughtSpot Analytics com uma assinatura ativa do ThoughtSpot Embedded, poderá integrar o SpotterCode usando a URL do servidor MCP do SpotterCode no seu aplicativo de codificação.

A ThoughtSpot fornece os seguintes endpoints de servidor MCP para o SpotterCode:

Endpoint	URL	Ferramentas disponíveis
Endpoint autenticado
(/mcp)

|

https://spottercode.thoughtspot.app/mcp
O endpoint do SpotterCode com capacidade total. Requer autenticação com uma instância da ThoughtSpot. Você pode usar este endpoint MCP para executar operações de usuário autenticadas na sua instância da ThoughtSpot por meio das APIs REST públicas.

|

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

| | Endpoint de documentação
(/mcp/docs)

|

https://spottercode.thoughtspot.app/mcp/docs
Este endpoint inclui apenas habilidades de recuperação de documentação e não requer autenticação. Use este endpoint se você precisar apenas que o agente de IA consulte a documentação para desenvolvedores da ThoughtSpot e a referência da API REST, sem se conectar a uma instância ativa da ThoughtSpot.

|

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

|

Ferramentas MCP compatíveis

O SpotterCode fornece as seguintes habilidades ao agente de IA no seu IDE. As habilidades autenticadas exigem uma sessão válida da ThoughtSpot estabelecida por meio do fluxo de autenticação do SpotterCode.

• get-rest-api-reference
  Fornece especificações da API REST, endpoints, formatos de solicitação/resposta, fluxos de autenticação, operações CRUD e SDKs para TypeScript e Java.

• get-developer-docs-reference
  Fornece acesso à documentação sobre incorporação, personalização de interface, implantação, segurança e práticas recomendadas.

• execute-thoughtspot-code
  Executa fluxos de trabalho autenticados da API da ThoughtSpot diretamente do agente do seu IDE. Esta habilidade permite que o agente do seu IDE execute operações comuns que podem ser feitas por meio das APIs REST públicas.

Escolhendo o endpoint certo

Use as seguintes orientações para decidir qual endpoint configurar no seu IDE:

• Use /mcp (autenticado) se:

  • Você deseja que o agente de IA execute fluxos de trabalho da API da ThoughtSpot a partir do seu IDE, por exemplo, para gerar uma chave secreta de autenticação confiável, configurar o domínio do seu aplicativo nas listas de permissões de CORS/CSP ou recuperar IDs de objetos de Liveboard e Answer da sua instância.

  • Você deseja que seu IDE use o conjunto completo de habilidades do SpotterCode, incluindo run-ts-workflow.

  • Você está criando ou configurando um aplicativo incorporado da ThoughtSpot e deseja assistência de configuração de ponta a ponta sem sair do IDE.

• Use /mcp/docs (não autenticado) se:

  • Você precisa apenas que o agente de IA consulte documentação, material de referência da API REST e exemplos de código.

  • Você está trabalhando em um ambiente onde conectar-se a uma instância da ThoughtSpot não é apropriado. Por exemplo, um ambiente de CI compartilhado, uma estação de trabalho de desenvolvedor somente leitura ou uma configuração de demonstração.

  • Você não tem uma assinatura do ThoughtSpot Embedded ou credenciais de instância disponíveis.

NOTA: As etapas de configuração do IDE neste guia usam o endpoint /mcp autenticado por padrão. Se você quiser usar o endpoint /mcp/docs não autenticado, substitua a URL do endpoint no trecho de configuração relevante antes de salvar. Todas as outras etapas de configuração permanecem as mesmas.

Segurança e governança de dados

O SpotterCode foi projetado para operar dentro do modelo de segurança e governança existente da ThoughtSpot. A tabela a seguir mostra quais dados o SpotterCode envia ao seu servidor MCP hospedado e como seus controles de acesso da ThoughtSpot se aplicam em todas as superfícies do SpotterCode.

Superfície	Autenticação necessária	RLS/CLS aplicado	Conecta-se à instância da ThoughtSpot	Dados enviados ao servidor MCP
IDE

|

Sim. OAuth/SAML ou token bearer

|

Sim

|

Sim

|

Consultas do usuário, solicitações de chamadas de ferramentas do agente do IDE e o contexto de autenticação necessário para executar código em nome do usuário. O SpotterCode não envia seu código-fonte, conteúdo de arquivos locais ou estrutura do projeto ao servidor MCP.

| | Visual Embed Playground

|

Sim. Requer uma sessão ativa da ThoughtSpot.

|

Sim

|

Sim

|

Consultas do usuário enviadas na sessão do Playground. O Playground opera dentro da sua sessão autenticada da ThoughtSpot. Nenhuma credencial adicional é transmitida separadamente.

| | Site de documentação para desenvolvedores

|

Não

|

N/A

|

Não

|

Consultas do usuário e contexto da página. Nenhuma autenticação ou dados de instância são necessários. A superfície do site de documentação é publicamente acessível.

| | | | | | |

Controles de acesso e governança da ThoughtSpot

O SpotterCode não contorna nem modifica o modelo de controle de acesso existente da ThoughtSpot. Quando o SpotterCode executa operações na sua instância da ThoughtSpot por meio da ferramenta execute-thoughtspot-code, ele atua como o usuário autenticado cujo token de sessão está em uso e pode executar operações de leitura e gravação permitidas para esse usuário. Os seguintes recursos de segurança da ThoughtSpot permanecem em vigor:

Como o código é executado como o usuário autenticado, operações de gravação, como criar, atualizar, excluir e compartilhar, geram as mesmas entradas de log de auditoria que chamadas equivalentes da API REST feitas diretamente por esse usuário. Para obter detalhes sobre os eventos capturados e como recuperá-los, consulte Logs de auditoria e API de logs de auditoria.

NOTA: O SpotterCode executa operações como o usuário autenticado. Conceda acesso ao SpotterCode apenas a contas com as permissões mínimas necessárias para o caso de uso pretendido.

Limitações

• As respostas do SpotterCode são determinadas pelos recursos e parâmetros atualmente compatíveis com o Visual Embed SDK, a API REST e a documentação oficial para desenvolvedores da ThoughtSpot. O SpotterCode não pode gerar código ou soluções que dependam de recursos não compatíveis ou não documentados.

• O SpotterCode pode gerar exemplos de código para os casos de uso mais comuns. Cenários que exigem personalização avançada ou fluxos de trabalho altamente especializados podem exigir intervenção manual ou codificação adicional além do que o SpotterCode fornece.

• O SpotterCode não influencia como o recurso Spotter na sua incorporação da ThoughtSpot infere modelagem semântica. O SpotterCode não se destina a consultar modelos de dados ou interpretar definições como medidas e atributos nos seus objetos de metadados.

• O comportamento do agente do IDE, incluindo seleção de ferramentas e raciocínio, não é controlado pelo SpotterCode.

Próximas etapas

[

Integrar o SpotterCode ao seu IDE

Conecte seu ambiente de desenvolvimento ao SpotterCode e use as habilidades do SpotterCode.

](../docs/integrate-SpotterCode)

[

Ver exemplos de prompts e práticas recomendadas

Aprenda a usar o SpotterCode no seu IDE para obter melhores resultados e explore exemplos de prompts.

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