MCP Remote Filesystem Gateway

Connect with API Key

Status: Disconnected

No file selected

MCP Live Protocol Inspector

Waiting for connection...

Administrator Authentication

Enter master admin key to view and issue directory keys.

Status	Name	Git User	Allowed Directory	API Key	Created	Actions
No keys loaded.

Git Repository Operations

Git User: - Branch: -

Custom Git Command Execution

git

Git Output Console

Connect with API key on the File Explorer tab, then use Git controls here.

Claude Desktop Configuration

Add this server block to your claude_desktop_config.json file:

{
  "mcpServers": {
    "remote-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rmaa.agency/sse?apiKey=YOUR_API_KEY",
        "--transport",
        "sse-only"
      ]
    }
  }
}

Cursor / IDE Configuration

In Cursor Features → MCP, add a new server with transport type SSE:

Name: Remote Filesystem
Type: sse
URL:  https://mcp.rmaa.agency/sse?apiKey=YOUR_API_KEY

SSH CLI Administration (mcp-admin)

You can also manage keys directly over SSH from your terminal:

ssh user@mcp.rmaa.agency

# List all keys
mcp-admin list

# Issue key for a directory
mcp-admin create --dir /home/user/my-project --name "My Project"

# Disable access
mcp-admin disable k_xxxx

# View master admin key
mcp-admin admin-key

ChatGPT Apps SDK File List UI OpenAI Apps SDK Ready

This interactive File List UI is built with the OpenAI Apps SDK. When ChatGPT invokes the list_files or browse_files tool, or a user triggers the Browse Files quick action, ChatGPT renders this widget inline in the chat conversation.

ChatGPT Widget Host Container (postMessage RPC & MCP Apps Protocol)

Resource: ui://files/list.html • ui://widget/file-browser.html

ChatGPT Host Protocol & Prompt Interceptor

Waiting for interaction in widget... Click "💬 Ask" inside the file list or file preview above to see the intercepted OpenAI Apps SDK message.

OpenAI Apps SDK Tool & Resource Specification

The gateway exposes the list_files / browse_files tools and the ui://files/list.html / ui://widget/file-browser.html UI resources compliant with the OpenAI MCP Extensions specification:

Tool Metadata (_meta.openai/ui):

{
  "name": "list_files",
  "_meta": {
    "ui": {
      "resourceUri": "ui://files/list.html"
    },
    "openai/ui": {
      "entrypoints": [
        {
          "type": "global",
          "quickAction": {
            "title": "Browse Files",
            "target": {
              "type": "tool",
              "name": "list_files",
              "arguments": {}
            }
          }
        }
      ],
      "preferredModelDisplayMode": "inline"
    }
  }
}

Resource Metadata (ui://files/list.html):

{
  "uri": "ui://files/list.html",
  "name": "ChatGPT File List UI",
  "mimeType": "text/html;profile=mcp-app",
  "_meta": {
    "openai/ui": {
      "availableDisplayModes": ["inline", "fullscreen"],
      "preferredDisplayMode": "inline"
    }
  }
}

How to Connect ChatGPT to this MCP Gateway

In ChatGPT, open Settings → Connected Apps (or configure your Custom GPT / Assistant).
Add a new MCP Action / Connector with transport type SSE (Server-Sent Events).

Set the endpoint URL to:

https://mcp.rmaa.agency/sse?apiKey=YOUR_API_KEY

ChatGPT automatically discovers the list_files / browse_files tools and the UI resources.
When ChatGPT calls list_files or the user clicks "Browse Files", the interactive File List UI renders directly inside the ChatGPT conversation!