{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "FlashyOS MCP server — install per harness",
  "url": "https://flashyos.com/developers/harnesses.json",
  "package": "@flashyos/mcp",
  "placeholders": {
    "orgId": "<your org id>",
    "agentName": "<a name for this agent>",
    "token": "<agent token>"
  },
  "variables": [
    "FLASHYOS_ORG_ID",
    "FLASHYOS_AGENT_NAME",
    "FLASHYOS_AGENT_TOKEN"
  ],
  "human": "https://flashyos.com/developers#harness",
  "cli": "npx @flashyos/mcp --print-config --harness <id>",
  "ids": [
    "claude-code",
    "codex",
    "opencode",
    "cursor",
    "claude-desktop",
    "windsurf",
    "gemini-cli",
    "mcp-json"
  ],
  "note": "Each format was read from the harness’s own documentation on formatAsOf; nothing here claims a harness lists or endorses FlashyOS. Fill the three placeholders with the values the dashboard mints or init writes.",
  "harnesses": [
    {
      "id": "claude-code",
      "label": "Claude Code",
      "kind": "command",
      "path": null,
      "source": "https://docs.claude.com/en/docs/claude-code/mcp",
      "formatAsOf": "2026-10-10",
      "note": "Run it in the project you want the tools in; add --scope user to have them everywhere.",
      "install": "claude mcp add flashyos -e FLASHYOS_ORG_ID='<your org id>' -e FLASHYOS_AGENT_NAME='<a name for this agent>' -e FLASHYOS_AGENT_TOKEN='<agent token>' -- npx -y @flashyos/mcp"
    },
    {
      "id": "codex",
      "label": "Codex CLI",
      "kind": "file",
      "path": "~/.codex/config.toml",
      "source": "https://github.com/openai/codex/blob/main/docs/config.md",
      "formatAsOf": "2026-10-10",
      "note": "Append to the file; keep any [mcp_servers.*] tables you already have.",
      "install": "[mcp_servers.flashyos]\ncommand = \"npx\"\nargs = [\"-y\", \"@flashyos/mcp\"]\n\n[mcp_servers.flashyos.env]\nFLASHYOS_ORG_ID = \"<your org id>\"\nFLASHYOS_AGENT_NAME = \"<a name for this agent>\"\nFLASHYOS_AGENT_TOKEN = \"<agent token>\""
    },
    {
      "id": "opencode",
      "label": "OpenCode",
      "kind": "file",
      "path": "opencode.json",
      "source": "https://opencode.ai/docs/mcp-servers/",
      "formatAsOf": "2026-10-10",
      "note": "In the project root, or ~/.config/opencode/opencode.json for every project. Merge the \"mcp\" key if the file exists.",
      "install": "{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"flashyos\": {\n      \"type\": \"local\",\n      \"command\": [\n        \"npx\",\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"enabled\": true,\n      \"environment\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    },
    {
      "id": "cursor",
      "label": "Cursor",
      "kind": "file",
      "path": ".cursor/mcp.json",
      "source": "https://docs.cursor.com/context/model-context-protocol",
      "formatAsOf": "2026-10-10",
      "note": "In the project, or ~/.cursor/mcp.json for every project.",
      "install": "{\n  \"mcpServers\": {\n    \"flashyos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"env\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    },
    {
      "id": "claude-desktop",
      "label": "Claude Desktop",
      "kind": "file",
      "path": "~/Library/Application Support/Claude/claude_desktop_config.json",
      "source": "https://modelcontextprotocol.io/quickstart/user",
      "formatAsOf": "2026-10-10",
      "note": "On Windows the file is %APPDATA%\\Claude\\claude_desktop_config.json. Restart the app after saving.",
      "install": "{\n  \"mcpServers\": {\n    \"flashyos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"env\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    },
    {
      "id": "windsurf",
      "label": "Windsurf",
      "kind": "file",
      "path": "~/.codeium/windsurf/mcp_config.json",
      "source": "https://docs.windsurf.com/windsurf/cascade/mcp",
      "formatAsOf": "2026-10-10",
      "note": null,
      "install": "{\n  \"mcpServers\": {\n    \"flashyos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"env\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    },
    {
      "id": "gemini-cli",
      "label": "Gemini CLI",
      "kind": "file",
      "path": "~/.gemini/settings.json",
      "source": "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md",
      "formatAsOf": "2026-10-10",
      "note": "Merge the \"mcpServers\" key into the settings you already have.",
      "install": "{\n  \"mcpServers\": {\n    \"flashyos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"env\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    },
    {
      "id": "mcp-json",
      "label": "Any other MCP host",
      "kind": "file",
      "path": null,
      "source": "https://modelcontextprotocol.io/docs/concepts/transports",
      "formatAsOf": "2026-10-10",
      "note": "The stdio server definition most hosts accept under a \"mcpServers\" key; see your host for where it reads it.",
      "install": "{\n  \"mcpServers\": {\n    \"flashyos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@flashyos/mcp\"\n      ],\n      \"env\": {\n        \"FLASHYOS_ORG_ID\": \"<your org id>\",\n        \"FLASHYOS_AGENT_NAME\": \"<a name for this agent>\",\n        \"FLASHYOS_AGENT_TOKEN\": \"<agent token>\"\n      }\n    }\n  }\n}"
    }
  ]
}