From f3a794f727637086939f1e3742c5f3b3c1201eb8 Mon Sep 17 00:00:00 2001
From: FLUJO <300233937+flujo-app@users.noreply.github.com>
Date: Tue, 8 Sep 2026 05:05:04 +0000
Subject: [PATCH] docs: add FLUJO remote client guide

---
 docs/installation-guides/README.md        |  2 ++
 docs/installation-guides/install-flujo.md | 29 +++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 docs/installation-guides/install-flujo.md

diff --git a/docs/installation-guides/README.md b/docs/installation-guides/README.md
index 46581aa77e..c2930d7768 100644
--- a/docs/installation-guides/README.md
+++ b/docs/installation-guides/README.md
@@ -9,6 +9,7 @@ This directory contains detailed installation instructions for the GitHub MCP Se
 - **[Claude Applications](install-claude.md)** - Installation guide for Claude Desktop and Claude Code CLI
 - **[Cline](install-cline.md)** - Installation guide for Cline
 - **[Cursor](install-cursor.md)** - Installation guide for Cursor IDE
+- **[FLUJO](install-flujo.md)** - Manual remote setup with a secret Bearer header and read-only repository tools
 - **[Google Gemini CLI](install-gemini-cli.md)** - Installation guide for Google Gemini CLI
 - **[OpenAI Codex](install-codex.md)** - Installation guide for OpenAI Codex
 - **[OpenCode](install-opencode.md)** - Installation guide for the OpenCode terminal agent
@@ -30,6 +31,7 @@ This directory contains detailed installation instructions for the GitHub MCP Se
 | Claude Desktop | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Moderate |
 | Cline | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
 | Cursor | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
+| FLUJO | Not tested | Bearer header (read-only repository tools verified) | FLUJO, authorized GitHub access token | Easy |
 | Google Gemini CLI | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
 | OpenCode | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
 | Roo Code | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
diff --git a/docs/installation-guides/install-flujo.md b/docs/installation-guides/install-flujo.md
new file mode 100644
index 0000000000..3cc662da80
--- /dev/null
+++ b/docs/installation-guides/install-flujo.md
@@ -0,0 +1,29 @@
+# Remote GitHub MCP server in FLUJO
+
+Connect [FLUJO](https://flujo.com.co/) to the hosted GitHub MCP server and verify a repository read using its built-in tool tester. This guide covers a manual Bearer header and the read-only repository toolset.
+
+## Prerequisites
+
+- A running FLUJO instance.
+- A GitHub access token authorized to read the repository you want to test. The recorded validation used the token from an existing authorized GitHub CLI session, available with `gh auth token`. Paste the token only into the secret header field below.
+
+See the [remote server documentation](../remote-server.md) for authentication and toolset options.
+
+## Connect and test
+
+1. In FLUJO, open **Connected Apps > Connect App > I have connection details > At a remote URL**.
+2. Enter `https://api.githubcopilot.com/mcp/x/repos/readonly` and select **Connect**.
+3. Select **Continue to setup**. The initial test without a header will report that authentication is required.
+4. Under **Custom HTTP headers**, select **Add header**. Set **Header** to `Authorization`, enable **Secret**, then enter `Bearer YOUR_ACCESS_TOKEN` as the value. Replace the placeholder with your token.
+5. Leave the OAuth client fields blank for this manual-header route. Select **3) Test run**.
+6. After the MCP handshake passes and tools are discovered, select **Update server**.
+7. Open the saved server's **Tools** tab and choose `get_file_contents`.
+8. Enter the repository's `owner`, `repo`, and file `path`, then select **Test tool**. The result should contain the requested file.
+
+The endpoint restricts the exposed tools to repository reads. Token permissions still determine which repositories can be read; use only the permissions needed for your task.
+
+## Validation scope
+
+FLUJO 3.45.2 completed the authenticated handshake, discovered 13 tools, and retrieved a public text fixture through this route. The test supplied a GitHub CLI OAuth access token as a secret Bearer header; it did not test FLUJO's interactive OAuth flow or PAT-specific behavior.
+
+Local-server setup and other toolsets are not covered here. Interactive OAuth requires a registered GitHub App or OAuth app, as explained in the [host support notes](README.md#support-by-host-application).