English Français العربية

app.thoughtspot/mcp-server

السجل الرسمي أخرى

MCP Server for ThoughtSpot - provides OAuth authentication and tools for querying data

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع app.thoughtspot/mcp-server؟

  • Define schemas and tools in src/servers/tool-definitions.ts
  • Implement handlers in src/servers/mcp-server.ts
  • Update version registry in src/servers/version-registry.ts:
  • Add tests for new tools and version configurations
  • Update documentation in README.md

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http app-thoughtspot-mcp-server 'https://agent.thoughtspot.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "app-thoughtspot-mcp-server": {
            "type": "http",
            "url": "https://agent.thoughtspot.app/mcp"
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse app-thoughtspot-mcp-server 'https://agent.thoughtspot.app/sse'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "app-thoughtspot-mcp-server": {
            "type": "sse",
            "url": "https://agent.thoughtspot.app/sse"
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http app-thoughtspot-mcp-server 'https://agent.thoughtspot.app/bearer/mcp' --header 'Authorization: <Bearer token for authentication, have the ts-host as '\''token@ts-host'\'' or as a separate '\''x-ts-host'\'' header>' --header 'X-TS-Host: <ThoughtSpot instance URL, if not provided in the authorization header>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "app-thoughtspot-mcp-server": {
            "type": "http",
            "url": "https://agent.thoughtspot.app/bearer/mcp",
            "headers": {
                "Authorization": "<Bearer token for authentication, have the ts-host as 'token@ts-host' or as a separate 'x-ts-host' header>",
                "X-TS-Host": "<ThoughtSpot instance URL, if not provided in the authorization header>"
            }
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse app-thoughtspot-mcp-server 'https://agent.thoughtspot.app/bearer/sse' --header 'Authorization: <Bearer token for authentication, have the ts-host as '\''token@ts-host'\'' or as a separate '\''x-ts-host'\'' header>' --header 'X-TS-Host: <ThoughtSpot instance URL, if not provided in the authorization header>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "app-thoughtspot-mcp-server": {
            "type": "sse",
            "url": "https://agent.thoughtspot.app/bearer/sse",
            "headers": {
                "Authorization": "<Bearer token for authentication, have the ts-host as 'token@ts-host' or as a separate 'x-ts-host' header>",
                "X-TS-Host": "<ThoughtSpot instance URL, if not provided in the authorization header>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ThoughtSpot MCP Server
  2. Table of Contents
  3. Manual client registration
  4. Contributing

ThoughtSpot MCP Server

ThoughtSpot Spotter MCP Server provides a set of tools for querying and retrieving relevant data from your ThoughtSpot instance. Spotter connects to your ThoughtSpot instance, handles authentication securely, and returns live answers from your own data.

Table of Contents

Manual client registration

For MCP hosts which do not(yet) support Dynamic client registration, or they require statically adding Oauth Client Id etc. Go to this page, to register a new client and copy the details over. The most relevant values are Oauth Client Id and Oauth Client Secret which should be added when adding ThoughtSpot as an MCP connector in the MCP client (ChatGPT/Claude etc). The generated client details are only available when they are generated and are NOT available later for reference.

Associate with a ThoughtSpot instance

Manual client registration also allows to associate with a specific ThoughtSpot instance, so that your users do not have to enter the Thoughtspot instance URL when doing the authorization flow. While registering the Oauth client add ThoughtSpot URL to the appropriate value.

Restrict instances per domain

When the Worker serves several custom domains, you can limit which ThoughtSpot instances each domain accepts with the INSTANCE_ALLOWLIST_BY_HOST environment variable. Its value is a JSON object that maps a hostname to its allowed instance URLs:

{"mcp.example.com": ["https://instance-a.thoughtspot.cloud", "https://instance-b.thoughtspot.cloud"]}

On a listed hostname:

  • The authorization page shows a dropdown of the allowed instances instead of a free-text field.
  • POST /authorize rejects any other instance with a 400.
  • MCP requests (/mcp, /sse, /token/*, /bearer/*) for any other instance get a 403.

Hostnames that aren't listed behave as before. If the value is not valid JSON, the server rejects requests with a 500 instead of lifting the restriction.

Contributing

Local Development
  1. Install dependencies:
     npm install
  2. Set up environment variables:
    • Copy .dev.vars and fill in your ThoughtSpot instance URL and access token.
  3. Start the development server:
     npm run dev
Adding New Tools

When adding new MCP tools to the server:

  1. Define schemas and tools in src/servers/tool-definitions.ts
  2. Implement handlers in src/servers/mcp-server.ts
  3. Update version registry in src/servers/version-registry.ts:
    • Add new tools to appropriate version(s) in VERSION_REGISTRY
    • For new stable features, update DEFAULT_VERSION
    • For beta features, add to the beta version entry
  4. Add tests for new tools and version configurations
  5. Update documentation in README.md

Important: The version registry controls which tools are available in each API version. Make sure to add new tools to the correct version configuration to ensure they're accessible to users.

MCP Server, © ThoughtSpot, Inc. 2026

الأسئلة الشائعة

ما هو app.thoughtspot/mcp-server؟

MCP Server for ThoughtSpot - provides OAuth authentication and tools for querying data

كيف أثبّت app.thoughtspot/mcp-server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http app-thoughtspot-mcp-server 'https://agent.thoughtspot.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج app.thoughtspot/mcp-server إلى مفتاح API؟

نعم. يتطلب Authorization, X-TS-Host، وتضبطها في إعداداته.

هل app.thoughtspot/mcp-server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون app.thoughtspot/mcp-server؟

ينشره thoughtspot. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.