From b70ffb385de0a25d9c107f9686136353d86b0c2b Mon Sep 17 00:00:00 2001 From: Lukas Bindreiter Date: Mon, 29 Dec 2025 17:30:32 +0100 Subject: [PATCH] Document tilebox MCP server --- ai-assistance.mdx | 65 ++++++++++++++++++++++++++++------------------- 1 file changed, 39 insertions(+), 26 deletions(-) diff --git a/ai-assistance.mdx b/ai-assistance.mdx index d5d5702..c1820bb 100644 --- a/ai-assistance.mdx +++ b/ai-assistance.mdx @@ -4,42 +4,37 @@ description: Large Language Models (LLMs) are powerful tools for exploring and l icon: brain-circuit --- -## Providing complete Tilebox context +## Tilebox MCP Server -AI assistants and Large Language Models (LLMs) can answer questions, guide you in using Tilebox, suggest relevant sections in the documentation, and assist you in creating workflows. +The Model Context Protocol (MCP) is an open protocol that creates standardized connections between AI applications and +external services. Tilebox provides such an MCP server that exposes tools for listing, querying and retrieving the schema +of datasets, as well as tools for interacting with workflows. - -Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model. - - -The full content of the Tilebox documentation is available in plain markdown format at [https://docs.tilebox.com/llms-full.txt](https://docs.tilebox.com/llms-full.txt). Upload this document to your AI assistant or LLM to provide it with Tilebox-specific context. - - -The [Documentation Context](https://docs.tilebox.com/llms-full.txt) is updated whenever the documentation changes. If you download the file, refresh it occasionally to stay up-to-date. - - -## Providing tailored context via MCP +### How the Tilebox MCP servers can help -Tilebox Docs can be installed as an MCP tool, so an MCP client can ask for detailed context on specific topics. - -### For Claude Desktop +When an AI tool like Claude, Cursor, or ChatGPT has the Tilebox MCP server configured, it can proactively invoke relevant +tools. For example, when asking a question about a specific dataset, the AI tool can query the Tilebox MCP server for the +dataset schema and include the correct, and up-to-date information about it in the response. -Run the following command to add Tilebox Docs to Claude: +Tilebox provides two MCP servers: -```bash -claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp -``` +- `https://mcp.tilebox.com/` - This MCP server provides tools for accessing and interacting with Tilebox datasets and workflows. It requires authentication using a Tilebox API key. +- `https://docs.tilebox.com/mcp` - This MCP server provides access to the Tilebox documentation. It does not require authentication. When configured, AI agents can ask for detailed context on specific topics. -### For other MCP clients +### Configuring the Tilebox MCP servers -1. Open command palette (Cmd+Shift+P / Ctrl+Shift+P) -2. Search "Open MCP settings" -3. Select "Add custom MCP" -4. Add to mcp.json: +To configure your AI tools to use the Tilebox MCP servers, you need to point it to the correct URLs using the `http` transport. +Additionally you'll need to provide an `Authorization` header with your Tilebox API key as the bearer token for the `https://mcp.tilebox.com/` server. ```json { "mcpServers": { + "tilebox": { + "url": "https://mcp.tilebox.com/", + "headers": { + "Authorization": "Bearer " + } + }, "tilebox-docs": { "url": "https://docs.tilebox.com/mcp" } @@ -47,6 +42,24 @@ claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp } ``` +### For Claude Desktop + +Run the following commands to add the Tilebox MCP server to Claude: + +```bash +claude mcp add --transport http "Tilebox" https://mcp.tilebox.com/ --header "Authorization: Bearer " +claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp +``` + +## Providing the full Tilebox documentation as context + + +Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model. + + +The full content of the Tilebox documentation is available in plain markdown format at [https://docs.tilebox.com/llms-full.txt](https://docs.tilebox.com/llms-full.txt). Upload this document to your AI assistant or LLM to provide it with Tilebox-specific context. + -The MCP server always retrieves the most up to date version of the documentation. +The [Documentation Context](https://docs.tilebox.com/llms-full.txt) is updated whenever the documentation changes. If you download the file, refresh it occasionally to stay up-to-date. +