Add documentation for the mcp plugin

Author: bcbogdan

docs/authentication/ai/_category_.json

@@ -0,0 +1,101 @@
+---
+title: Authenticate MCP Servers
+hide_title: true
+sidebar_position: 1
+pagination_next: null
+pagination_prev: null
+skip_llms_txt: true
+description: >-
+  Authenticate MCP server actions using the SuperTokens MCP plugin 
+  to use with AI tools and agents.
+---
+
+# Authenticate MCP Servers
+
+This guide explains how to authenticate MCP Servers using the provided code snippet. Follow the steps below to integrate and initialize your MCP server with SuperTokens.
+
+## Overview
+
+This guide covers the following topics:
+
+-  Installing the MCP plugin.
+-  Initializing the plugin.
+-  Registering tools.
+-  Initializing the SDK.
+
+We use a sample code snippet to illustrate the server configuration and how to add administrative tools.
+
+## Before you start
+
+Before setting up your MCP servers, ensure you have:
+
+-  Installed the required packages (e.g., **mcp-plugin** and its dependencies).
+-  Configured your authentication system with SuperTokens.
+-  Setup your development environment with Node.js.
+
+Review your permission requirements, as the servers validate user roles to authorize access.
+
+## Steps
+
+### 1. Install the plugin
+
+Install the MCP plugin via npm:
+
+```bash
+npm install mcp-plugin
+```
+
+
Ensure that all dependencies for SuperTokens are also installed according to your project requirements.
+
+### 2. Initialize the plugin
+
+In your project file, import the necessary components and initialize your MCP server. The following example shows how to create an instance of ⁠SuperTokensMCPServer and configure its basic parameters:
+
+```ts
+import { MCPPlugin, SuperTokensMCPServer, AdminToolMCPServer } from "mcp-plugin";
+
+const mcpServer = new SuperTokensMCPServer({
+    name: "mcp-server",
+    version: "1.0.0",
+    path: "/mcp-server-for-admins",
+    claimValidators: [{
+        UserRoles.validate.includesAll("admin")
+    }],
+});
+```
+
+### 3. Register your tools
+
+Register the tool with your MCP server. This step involves defining the tool name, description, and an execution function that processes the input and returns an output. The execution function used in the example fetches a user by ID and returns a simple greeting:
+
+```ts
+
+mcpServer.registerTool({
+    name: "mcp-server",
+    description: "A tool for the mcp-server",
+    execute: (toolInput, extra) => {
+        const { user } = getUserById(extra._meta.accessTokenPayload.sub);
+        return {
+            output: "Hello, world!",
+        };
+    },
+});
+```
+
+Create an administrative version of the MCP server using the ⁠AdminToolMCPServer class. This server uses a different claim validator to enforce additional role-based constraints:
+
+
+### 4. Initialize the SDK
+
+Finally, initialize the SuperTokens SDK and add the MCP plugin to your SuperTokens configuration. The MCP plugin is provided with both the standard and administrative server configurations:
+
+```ts
+SuperTokens.init({
+    plugins: [
+        new MCPPlugin({
+            mcpServers: [mcpServer, adminToolMCPServer],
+        }),
+    ],
+})
+```
+

docs/authentication/ai/authenticate-mcp-servers.mdx

@@ -0,0 +1 @@
+

docs/authentication/ai/introduction.mdx

@@ -0,0 +1,33 @@
+
+# Build with AI Tools
+
+## Overview
+
+If you plan on using LLMs to assist in the building of SuperTokens integrations, reference this guide to improve your development experience.
+The documentation has various helper tools that can aid you when you are interacting with different AI tools
+
+## Text documentation
+
+You can access all the documentation as plain text markdown files by appending `.md` to the end of any URL.
+For example, you can find the plain text version of this page at [https://supertokens.com/docs/quickstart/build-with-ai-tools.md](https://supertokens.com/docs/quickstart/build-with-ai-tools.md).
+
+This plain text format is ideal for AI tools and agents as it:
+-  Contains fewer formatting tokens.
+-  Displays content that might otherwise be hidden in the HTML or JavaScript-rendered version (such as content in tabs).
+-  Maintains a clear markdown hierarchy that LLMs can easily parse and understand.
+
+https://llmstxt.org
+
+### `/llms.txt`
+
+We also host an [/llms.txt file](https://docs.supertokens.com/llms.txt.md) which instructs AI tools and agents on how to retrieve the plain text versions of our pages. The `/llms.txt` file follows an [emerging standard](https://llmstxt.org/) for enhancing content accessibility to LLMs.
+
+
+Additionally, our documentation pages feature buttons for copying the docs as markdown and for opening the full documentation page in an AI chat interface.
+
+## Model Context Protocol (MCP) Server
+
+You can use the SuperTokens Model Context Protocol (MCP) server if you use AI-enhanced code editors (such as Cursor or Windsurf) or general purpose tools like Claude Desktop.
+The MCP server provides AI agents a suite of tools to call the SuperTokens API and search our knowledge base (documentation, support articles, and more).
+
+For a local setup, you can run the [local SuperTokens MCP server](https://github.com/supertokens/agent-toolkit/tree/main/modelcontextprotocol).