diff --git a/ai-assistance.mdx b/ai-assistance.mdx index e9bd5c3..d6e04cb 100644 --- a/ai-assistance.mdx +++ b/ai-assistance.mdx @@ -16,17 +16,16 @@ When an AI tool like Claude, Cursor, or ChatGPT has the Tilebox MCP server confi 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. -Tilebox provides two MCP servers: +The Tilebox MCP server at `https://mcp.tilebox.com/` provides tools for: +- Accessing and interacting with Tilebox datasets and workflows +- Searching the Tilebox documentation -- `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. +It requires authentication using a Tilebox API key. When configured, AI agents can query datasets, interact with workflows, and search the documentation for detailed context on specific topics. -Together, these two MCP servers provide a powerful way to interact with Tilebox using AI tools. A coding assistant can learn how to use and write code against Tilebox APIs (by using and exploring the docs), but then also specifically customize the code depending on actually available datasets, and their exact schema, queried from the Tilebox MCP server. +### Configuring the Tilebox MCP server -### Configuring the Tilebox MCP servers - -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. +To configure your AI tools to use the Tilebox MCP server, you need to point it to the correct URL using the `http` transport. +Additionally you'll need to provide an `Authorization` header with your Tilebox API key as the bearer token. ```json { @@ -36,9 +35,6 @@ Additionally you'll need to provide an `Authorization` header with your Tilebox "headers": { "Authorization": "Bearer " } - }, - "tilebox-docs": { - "url": "https://docs.tilebox.com/mcp" } } } @@ -46,17 +42,16 @@ Additionally you'll need to provide an `Authorization` header with your Tilebox ### For Claude Desktop -Run the following commands to add the Tilebox MCP server to Claude: +Run the following command 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 -Rather than relying on the Tilebox Docs MCP server, you can also provide the full Tilebox documentation as context to your AI assistant or language model. -To do so, you can download the complete documentation as a plain text file below. This is an alternative to configuring the `https://docs.tilebox.com/mcp` MCP server. +As an alternative to using the MCP server's documentation search, you can also provide the full Tilebox documentation as context to your AI assistant or language model. +To do so, you can download the complete documentation as a plain text file below. Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model.