From 55f15465579198c72c94025db662b0700e8eaa7a Mon Sep 17 00:00:00 2001 From: ShashiSubramanya Date: Thu, 6 Aug 2026 08:26:22 +0530 Subject: [PATCH 1/2] SCAL-330067 updates --- .../pages/mcp-server-client-connection.adoc | 35 ++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/mcp-server-client-connection.adoc b/modules/ROOT/pages/mcp-server-client-connection.adoc index e23efaa30..82cb6fd91 100644 --- a/modules/ROOT/pages/mcp-server-client-connection.adoc +++ b/modules/ROOT/pages/mcp-server-client-connection.adoc @@ -124,7 +124,6 @@ OAuth clients can be registered in one of the following ways: + To register a client, visit link:https://agent.thoughtspot.app/clients[ThoughtSpot MCP OAuth Client Registration, window=_blank]. When registering the OAuth client, add your ThoughtSpot instance URL to the appropriate field. This ensures that users are not prompted to enter the instance URL during the OAuth flow, and the OAuth redirect returns correctly to your ThoughtSpot environment after login. - == Verifying integration After the MCP Server is connected, some clients show *ThoughtSpot Data Sources* under a *Resources* or *Datasets* section. @@ -134,6 +133,40 @@ To verify the integration: . Verify that MCP tools are being called to generate responses. See the xref:mcp-tool-reference-guide.adoc[MCP tool reference guide] for information about tool calls. . Try the Liveboard creation request and verify whether a Liveboard is added to your ThoughtSpot application. +== Using the ThoughtSpot skill with skill-aware clients +Some LLM clients, such as Claude, support skills—packaged sets of instructions and best practices that an agent can load on demand to perform specific tasks more reliably. +Alongside the ThoughtSpot Spotter MCP Server, ThoughtSpot provides a companion skill that helps skill-aware clients use the MCP tools more effectively. For example, routing questions intelligently, streaming its thinking as it works, and surfacing ThoughtSpot's own visualizations instead of generating charts. + +[NOTE] +==== +The skill is installed separately from the connector. Connecting the ThoughtSpot Spotter connector (or configuring the MCP server) gives your client access to the available tools. Installing the skill doesn't provide the tools themselves; instead, it helps the client understand when and how to orchestrate those tools effectively. You can use the MCP server without the skill, but clients that support skills generally produce better results when both the connector and the skill are installed. +==== + +=== Before you begin + +* Connect the ThoughtSpot Spotter MCP Server to your client. +See xref:mcp-server-client-connection.adoc#_using_thoughtspot_spotter_with_chatgpt_and_claude[Using ThoughtSpot Spotter with ChatGPT and Claude] and the connection sections above. +* Confirm your client supports skills. +Clients without skill support can still use the MCP Server directly; the skill is an enhancement, not a requirement. + +=== Adding the skill + +. Get the ThoughtSpot skill (`analyzing-data-with-thoughtspot`) from the link:https://github.com/thoughtspot/mcp-server/tree/main/skills[ThoughtSpot MCP Server repository, window=_blank]. +. Add the skill in your client, following the client's documentation for installing and enabling skills. +. Confirm the skill is enabled and loaded in your client. + +=== Verifying the skill + +. Start a chat session with the agent and ask a data question. +. Verify that the ThoughtSpot MCP tools are being called to generate the response. +See the xref:mcp-tool-reference-guide.adoc[MCP tool reference guide] for information about tool calls. +. Confirm the skill is influencing behavior. For example, more accurate data-context selection, cleaner chart generation, and successful Liveboard creation from the conversation. + +[NOTE] +==== +Skill availability and installation steps may vary by client. Refer to your client's documentation for instructions on adding and managing skills. +==== + == Troubleshooting errors MCP Server is not connected:: From 90147093e829f28a8145550175cb6a7a723fa5bb Mon Sep 17 00:00:00 2001 From: ShashiSubramanya Date: Thu, 6 Aug 2026 08:55:48 +0530 Subject: [PATCH 2/2] menu and css edits for typedoc files --- modules/ROOT/pages/common/nav-mcp-server.adoc | 4 +-- src/assets/styles/index.scss | 25 +++++++++++++++++++ 2 files changed, 27 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/common/nav-mcp-server.adoc b/modules/ROOT/pages/common/nav-mcp-server.adoc index 7f98f2117..e1be3a313 100644 --- a/modules/ROOT/pages/common/nav-mcp-server.adoc +++ b/modules/ROOT/pages/common/nav-mcp-server.adoc @@ -8,8 +8,8 @@ ThoughtSpot Spotter MCP Server * link:{{navprefix}}/mcp-integration[Overview] -** link:{{navprefix}}/mcp-server-spotter3[MCP Server with Spotter 3] -** link:{{navprefix}}/mcp-server-legacy[Legacy MCP Server architecture and tools] +* link:{{navprefix}}/mcp-server-spotter3[MCP Server with Spotter 3] +* link:{{navprefix}}/mcp-server-legacy[Legacy MCP Server architecture and tools] * link:{{navprefix}}/connect-mcp-server-to-clients[Connecting MCP Server to clients] * link:{{navprefix}}/custom-chatbot-integration-mcp[Integrating MCP Server in a custom app] diff --git a/src/assets/styles/index.scss b/src/assets/styles/index.scss index baf0ec97c..6ecb6ed39 100644 --- a/src/assets/styles/index.scss +++ b/src/assets/styles/index.scss @@ -1100,6 +1100,31 @@ a.anchor { background-position: -136px -68px; } } + +#wrapper[data-theme='dark'], +#docsModal[data-theme='dark'] { + .typedoc-Type_alias a, + .typedoc-Function a { + color: #71a1f4; + } + .typedoc-Type_alias :before, + .typedoc-Function :before { + background-image: none; + background-color: #71a1f4; + -webkit-mask-repeat: no-repeat; + mask-repeat: no-repeat; + -webkit-mask-image: url(../icons/icons.png); + mask-image: url(../icons/icons.png); + } + .typedoc-Type_alias :before { + -webkit-mask-position: 0px -170px; + mask-position: 0px -170px; + } + .typedoc-Function :before { + -webkit-mask-position: -136px -68px; + mask-position: -136px -68px; + } +} .header-banner { min-height: 240px; background: var(--header-banner-background);