Flotiq/feature/27873 add mcp docs

docs/Universe/MCP/chatgpt.md

@@ -0,0 +1,66 @@
+---
+tags:
+  - Developer
+  - Content Creator
+---
+
+title: Flotiq MCP Server in ChatGPT | Flotiq docs
+description: Connect your Flotiq content to ChatGPT using a custom MCP plugin.
+
+# Flotiq MCP Server in ChatGPT
+
+This guide shows how to connect the [Flotiq MCP Server](index.md) to ChatGPT as a custom plugin.
+
+## Prerequisites
+
+1. [Flotiq account](https://editor.flotiq.com){:target="_blank"}
+2. ChatGPT plan that supports custom connectors
+
+## Setup
+
+### 1. Enable Developer mode
+
+Go to [Settings → Plugins → Developer mode](https://chatgpt.com/#settings/Plugins){:target="_blank"} and turn
+on **Developer mode**.
+
+### 2. Open plugins configuration
+
+Go back to **Settings → Plugins** and click **Browse plugins**.
+
+![](../images/mcp/chatgpt-browse-plugins.png){: .center .width75 .border}
+
+### 3. Create the plugin
+
+Click **create**.
+
+![](../images/mcp/chatgpt-add-plugin.png){: .center .width75 .border}
+
+### 4. Enter the configuration
+
+![](../images/mcp/chatgpt-create-plugin.png){: .center .width50 .border}
+
+Confirm the risk notice and click **Create**.
+
+### 5. Sign in to Flotiq
+
+Click **Sign in with Flotiq CMS**. Flotiq takes you through the
+[authorization flow](index.md#authentication), where you pick the Space and the access scope.
+
+![](../images/mcp/chatgpt-sign-in.png){: .center .width75 .border}
+
+## Using the tools
+
+Start a new chat, make sure the Flotiq plugin is enabled in the message composer, and ask a question about your content:
+
+![](../images/mcp/chatgpt-usage.png){: .center .width75 .border}
+
+!!! Note
+    ChatGPT decides on its own which tools to call.
+    Read [Working safely with write tools](index.md#working-safely-with-write-tools) before letting it create or update
+    content.
+
+## Related docs
+
+- [Flotiq MCP Server overview](index.md)
+- [Universe overview](../overview.md)
+- [Get Started with API](../../API/get-started.md)

docs/Universe/MCP/claude.md

@@ -0,0 +1,64 @@
+---
+tags:
+  - Developer
+  - Content Creator
+---
+
+title: Flotiq MCP Server in Claude | Flotiq docs
+description: Connect your Flotiq content to Claude using a custom connector.
+
+# Flotiq MCP Server in Claude
+
+This guide shows how to connect the [Flotiq MCP Server](index.md) to Claude as a custom connector. It works in the
+Claude desktop app and on claude.ai.
+
+## Prerequisites
+
+1. [Flotiq account](https://editor.flotiq.com){:target="_blank"}
+2. Claude plan that supports custom connectors
+
+## Setup
+
+### 1. Open the connector list
+
+Go to **Settings → Connectors** and click **Add**.
+
+![](../images/mcp/claude-custom-connector.png){: .center .width75 .border}
+
+### 2. Enter the configuration
+
+Enter `Flotiq` as the name and `https://mcp.flotiq.com/mcp` as the URL, then click **Continue**.
+
+![](../images/mcp/claude-add-connector.png){: .center .width50 .border}
+
+![](../images/mcp/claude-add-connector_2.png){: .center .width50 .border}
+
+Leave the detected **No client ID - register one automatically** option and click **Add**.
+
+### 3. Connect
+
+Open the connector and click **Connect**.
+
+![](../images/mcp/claude-connect.png){: .center .width75 .border}
+
+Flotiq takes you through the [authorization flow](index.md#authentication), where you pick the Space and the access
+scope.
+
+### 4. Adjust tool permissions
+
+Open the connector in **Settings → Connectors → Flotiq** and set **Tool permissions** so Claude cannot change
+your content without asking. A good starting point:
+
+![](../images/mcp/claude-tool-permissions.png){: .center .width75 .border}
+
+## Using the tools
+
+Ask Claude about your content - it will pick the right tools on its own:
+
+![](../images/mcp/claude-usage.png){: .center .width75 .border}
+
+## Related docs
+
+- [Flotiq MCP Server overview](index.md)
+- [Universe overview](../overview.md)
+- [Get Started with API](../../API/get-started.md)

docs/Universe/MCP/codex.md

@@ -0,0 +1,52 @@
+---
+tags:
+  - Developer
+---
+
+title: Flotiq MCP Server in Codex | Flotiq docs
+description: Add the Flotiq MCP Server to your Codex CLI configuration.
+
+# Flotiq MCP Server in Codex
+
+This guide shows how to add the [Flotiq MCP Server](index.md) to the Codex CLI.
+
+## Prerequisites
+
+1. [Flotiq account](https://editor.flotiq.com){:target="_blank"}
+2. Codex CLI installed
+
+## Setup
+
+Add the following to your `~/.codex/config.toml` file:
+
+```toml
+experimental_use_rmcp_client = true
+
+[mcp_servers.flotiq]
+url = "https://mcp.flotiq.com/mcp"
+```
+{ data-search-exclude }
+
+!!! Note
+    `experimental_use_rmcp_client` is required - without it Codex uses the legacy MCP client, which does not support remote
+    HTTP servers with OAuth.
+
+Restart Codex. On the first tool call it opens the Flotiq [authorization flow](index.md#authentication) in your
+browser, where you pick the Space and the access scope.
+
+## Check the configuration
+
+Start Codex and ask it about your content, for example:
+
+```
+check how many content types i have in flotiq
+```
+{ data-search-exclude }
+
+Codex should call `data_efficient_list_ctd` and answer with the number of Content Types in the Space you connected.
+
+## Related docs
+
+- [Flotiq MCP Server overview](index.md)
+- [Universe overview](../overview.md)
+- [Get Started with API](../../API/get-started.md)

docs/Universe/MCP/copilot-cli.md

@@ -0,0 +1,54 @@
+---
+tags:
+  - Developer
+---
+
+title: Flotiq MCP Server in GitHub Copilot CLI | Flotiq docs
+description: Add the Flotiq MCP Server to GitHub Copilot CLI.
+
+# Flotiq MCP Server in GitHub Copilot CLI
+
+This guide shows how to add the [Flotiq MCP Server](index.md) to GitHub Copilot CLI.
+
+## Prerequisites
+
+1. [Flotiq account](https://editor.flotiq.com){:target="_blank"}
+2. GitHub Copilot CLI installed and authenticated with your GitHub account
+
+## Setup
+
+### 1. Add the server
+
+Start Copilot:
+
+```bash
+copilot
+```
+{ data-search-exclude }
+
+Run the `/mcp add` command and fill in the form:
+
+| Field       | Value                        |
+|-------------|------------------------------|
+| Name        | `FlotiqMCP`                  |
+| Server Type | `HTTP`                       |
+| URL         | `https://mcp.flotiq.com/mcp` |
+
+Press `Ctrl` + `S` to save. Copilot confirms with *MCP configuration saved successfully*.
+
+### 2. Authorize
+
+Press `Enter` on the authorization prompt to start the Flotiq [authorization flow](index.md#authentication), where
+you pick the Space and the access scope.
+
+## Check the configuration
+
+Ask Copilot about your content:
+
+![](../images/mcp/copilot-cli-usage.png){: .center .width75 .border}
+
+## Related docs
+
+- [Flotiq MCP Server overview](index.md)
+- [VS Code Copilot](copilot.md)
+- [Universe overview](../overview.md)

docs/Universe/MCP/copilot.md

@@ -0,0 +1,66 @@
+---
+tags:
+  - Developer
+---
+
+title: Flotiq MCP Server in VS Code Copilot | Flotiq docs
+description: Use Flotiq content directly from GitHub Copilot Chat in Visual Studio Code.
+
+# Flotiq MCP Server in VS Code Copilot
+
+This guide shows how to add the [Flotiq MCP Server](index.md) to GitHub Copilot Chat in Visual Studio Code.
+
+## Prerequisites
+
+1. [Flotiq account](https://editor.flotiq.com){:target="_blank"}
+2. Visual Studio Code with the GitHub Copilot Chat extension
+3. Copilot Chat running in **Agent** mode - MCP tools are not available in Ask mode
+
+## Setup
+
+### 1. Add the server
+
+Open the Command Palette (`Cmd/Ctrl` + `Shift` + `P`) and run **MCP: Add Server**.
+
+1. Choose **HTTP** as the server type
+2. Enter the URL: `https://mcp.flotiq.com/mcp`
+3. Enter `FlotiqMCP` as the server name
+4. Choose whether to store the configuration in your user settings or in the workspace
+
+VS Code starts the Flotiq [authorization flow](index.md#authentication) automatically, where you pick the Space and
+the access scope.
+
+### 2. Or edit `mcp.json` manually
+
+Instead of using the Command Palette you can add the server to `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "FlotiqMCP": {
+      "type": "http",
+      "url": "https://mcp.flotiq.com/mcp"
+    }
+  }
+}
+```
+{ data-search-exclude }
+
+## Check the configuration
+
+In the Copilot Chat sidebar click the **Tools** icon. You should see all Flotiq tools listed under `FlotiqMCP`:
+
+![](../images/mcp/vscode-tools.png){: .center .width75 .border}
+
+Leave only `data_efficient_list_ctd`, `get_content_type`, `list_objects` and `get_object` checked if you want Copilot
+to work in read-only mode.
+
+!!! Note
+    If the OAuth flow does not start, or fails with a registration error, your VS Code version may not support Dynamic
+    Client Registration. Update VS Code and the Copilot Chat extension, then remove and re-add the server.
+
+## Related docs
+
+- [Flotiq MCP Server overview](index.md)
+- [GitHub Copilot CLI](copilot-cli.md)
+- [Universe overview](../overview.md)