Skip to content

Add Warp (Warp.dev) configuration support #351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Add Warp (Warp.dev) configuration support #351

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b41cf55
add Warp (Warp.dev) configuration support
tanthcstt Oct 24, 2025
2e8aec7
fix manual config editor instruction for warp
tanthcstt Oct 24, 2025
f7fdab9
Merge branch 'CoplayDev:main' into warp_support
tanthcstt Oct 24, 2025
2c77de8
Update UnityMcpBridge/Editor/Windows/ManualConfigEditorWindow.cs, fix…
tanthcstt Oct 25, 2025
b68095c
Update UnityMcpBridge/Editor/Models/McpTypes.cs
tanthcstt Oct 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions MCPForUnity/Editor/Data/McpClients.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -208,6 +208,31 @@ public class McpClients
mcpType = McpTypes.Codex,
configStatus = "Not Configured",
},
// Warp
new()
{
name = "Warp",
windowsConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
"Warp",
"mcp.json"
),
macConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
"Library",
"Application Support",
"Warp",
"mcp.json"
),
linuxConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
".config",
"Warp",
"mcp.json"
),
mcpType = McpTypes.Warp,
configStatus = "Not Configured",
},
Comment on lines +211 to +235
Copy link
Contributor

@coderabbitai coderabbitai bot Oct 24, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Verify Warp configuration paths with official documentation.

The configuration paths follow the established pattern used by other clients (e.g., Trae), but it's important to confirm these are the actual paths used by Warp.dev for MCP configuration.

🌐 Web query:

What are the official MCP configuration file paths for Warp terminal?

💡 Result:

Short answer: Warp does not publish an official on-disk MCP configuration path. The MCP servers UI in Warp stores MCP settings in Warp Drive / the app settings (managed from Settings → AI → Manage MCP servers) and the product docs show how to add MCPs as JSON via the UI, but they do not document a stable file path you can edit on disk. [1][2]

Supporting links:

  • Warp MCP docs (shows where to manage/add MCP servers in the app but no filesystem path listed). [1]
  • Public GitHub issue asking for a local-on-disk MCP config location (Warp maintainers/docs don’t list one). [2]

If you need a writable file you can edit: many other MCP clients use a JSON file named mcp_config.json (examples: Windsurf / Codeium at ~/.codeium/windsurf/mcp_config.json, Windsurf docs) — but that is not Warp’s documented on-disk location. [3][4]

References

  1. Warp — Model Context Protocol (MCP) documentation (Manage MCP servers).
  2. warpdotdev/Warp GitHub issue “Support local MCP server config storage (not on Warp Drive)”.
  3. Windsurf / Codeium MCP config examples (~/.codeium/windsurf/mcp_config.json).
  4. Prisma / other MCP integration docs showing typical mcp_config.json usage.

Remove or reconcile Warp configuration paths—Warp does not document on-disk MCP configuration files.

Warp does not publish an official on-disk MCP configuration path. MCP settings are stored in Warp Drive and managed through the app UI (Settings → AI → Manage MCP servers), with no stable file path documented for editing on disk. A public GitHub issue requesting local on-disk MCP config support exists, but Warp maintainers do not document such a location.

The hardcoded paths in lines 211-235 assume Warp stores MCP configuration at specific filesystem locations, but this is not officially supported. Remove these paths or verify with Warp maintainers that these are actual implementation details (not documented as stable).

Copy link
Contributor

@msanatan msanatan Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this true? If it is, then this won't work, and we'll need a different approach to configure Warp

Copy link
Contributor

@coderabbitai coderabbitai bot Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧩 Analysis chain

🌐 Web query:

Warp terminal MCP configuration file location setup

💡 Result:

Short answer: Warp stores MCP server configs in your Warp application data and you can edit/add servers via the Warp UI (or CLI) using a JSON snippet.

Steps and locations:

  • Open Warp → Warp Drive (or Settings → AI → Manage MCP servers) → Personal → MCP Servers → + Add, then paste a JSON snippet that contains a "mcpServers" object with one or more server entries (each entry keys a name and has properties like command, args, env, working_directory, start_on_launch). Example JSON shown in the docs. [1]
  • On macOS the local MCP directory is: $HOME/Library/Application Support/dev.warp.Warp-Stable/mcp — you can cd there to inspect files. [1]
  • You can also manage MCP via the Warp CLI (use warp help mcp to list commands and usage). [2]

Example minimal MCP JSON structure:
{
"mcpServers": {
"myServer": {
"command": "npx",
"args": ["-y","@modelcontextprotocol/server-filesystem","/path/to/allowed/files"],
"env": {},
"working_directory": null,
"start_on_launch": true
}
}
}
(Use Warp’s Add UI to paste and save this.) [1]

If you want, tell me your OS and whether you prefer UI or CLI and I’ll give exact commands/paths for your setup.

Sources: Warp docs (MCP pages) [1], Warp CLI docs (mcp help) [2].

🌐 Web query:

Warp dev.warp.Warp-Stable mcp directory Windows Linux paths

💡 Result:

Locations for the Warp MCP directory (Stable build):

  • macOS: ~/Library/Application Support/dev.warp.Warp-Stable/mcp. [1]
  • Windows: %APPDATA%\dev.warp.Warp-Stable\mcp (per common Warp log/config locations). [2]
  • Linux: ~/.local/share/dev.warp.Warp-Stable/mcp (per common Warp data locations). [2]

Sources: Warp docs (macOS path shown). [1] Additional path examples / log-location references showing Windows/Linux equivalents. [2]

References:
[1] docs.warp.dev — Model Context Protocol (MCP) / examples.
[2] Glama / warp-sql-server-mcp debug docs (MCP log/location examples for macOS, Windows, Linux).

🌐 Web query:

Warp mcp directory structure configuration file format

💡 Result:

Short answer: Warp's MCP (Model Context Protocol) configuration is JSON. It uses a top-level object (commonly "mcpServers") whose keys are server names and whose values are server entries with fields like url (for SSE servers) or command/args/env/working_directory (for CLI servers), plus optional flags such as start_on_launch. Example and docs below.

Example JSON:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"],
"working_directory": "/path/to",
"env": { "TOKEN": "…" },
"start_on_launch": true
},
"externalDocs": {
"url": "http://localhost:4000/mcp"
}
}
}

Key fields:

  • mcpServers: object mapping server-name → server config. [1]
  • command: string (CLI server executable). [1]
  • args: string[] (CLI arguments). [1]
  • url: string (SSE/HTTP MCP server endpoint). [1]
  • env: object (env vars). [1]
  • working_directory: string (optional, recommended when using relative paths). [1]
  • start_on_launch: boolean (optional to prevent auto-start). [1]

Where it's used / managed:

  • Add/edit via Warp UI (Warp Drive → MCP Servers) or CLI; use warp mcp list/help for CLI interaction. [2]
  • Warp syncs MCP configs via Warp Drive (there are open requests about local-only storage). If you need a local storage location, note Warp's docs/GitHub issues indicate the config is synced and its on-disk layout is not fully documented. [1][4]

Sources:
[1] Warp MCP docs (Model Context Protocol) — examples and property descriptions. (docs.warp.dev)
[2] Warp CLI docs — warp mcp commands and usage. (docs.warp.dev)
[3] Warp University / MCP examples (GitHub/Figma examples). (warp.dev)
[4] Warp GitHub issue about local MCP config storage. (github.com)

Would you like the exact JSON schema extracted into a schema file (JSON Schema or TypeScript types) or help locating the local config file on your OS?

Citations:

@msanatan Yes, CodeRabbit's warning is accurate. The paths in this PR are incorrect, and more importantly, Warp's MCP configuration approach is fundamentally different from the other clients in your codebase.

Key Issues

1. Incorrect Paths

The PR uses:

  • macOS: ~/Library/Application Support/Warp/mcp.json
  • Windows: %APPDATA%\Warp\mcp.json
  • Linux: ~/.config/Warp/mcp.json

The actual Warp MCP locations are:

  • macOS: ~/Library/Application Support/dev.warp.Warp-Stable/mcp (directory, not file)
  • Windows: %APPDATA%\dev.warp.Warp-Stable\mcp (directory, not file)
  • Linux: ~/.local/share/dev.warp.Warp-Stable/mcp (directory, not file)

2. Different Configuration Model

Unlike other clients in your codebase (Cursor, Claude Desktop, Windsurf, etc.) that use directly editable JSON files, Warp:

  • Stores MCP configs in a directory structure (not a single JSON file)
  • Manages configuration through the Warp UI (Settings → AI → Manage MCP servers) or Warp CLI (warp mcp commands)
  • Syncs configuration via Warp Drive (cloud-based)
  • Does not officially document the on-disk format for direct file editing

Recommendation

You'll need a different integration approach for Warp. The current pattern of directly writing to a config file won't work. Consider:

  1. Instructing users to manually add the MCP server through Warp's UI/CLI
  2. Using Warp's CLI (warp mcp commands) if it supports programmatic configuration
  3. Investigating if there's an API or documented way to add MCP servers programmatically

Would you like me to help research Warp's CLI capabilities for programmatic MCP configuration?

Copy link
Contributor

@msanatan msanatan Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tanthcstt please look at this comment

Copy link
Contributor

@coderabbitai coderabbitai bot Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Author

@tanthcstt tanthcstt Oct 25, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@msanatan I see. It says there’s no evidence, but coderabbitai mentioned:

The actual Warp MCP locations are:

  • macOS: ~/Library/Application Support/dev.warp.Warp-Stable/mcp (directory, not file)
  • Windows: %APPDATA%\dev.warp.Warp-Stable\mcp (directory, not file)
  • Linux: ~/.local/share/dev.warp.Warp-Stable/mcp (directory, not file)

This is based on [Warp issue #6602](https://github.com/warpdotdev/Warp/issues/6602?utm_source=chatgpt.com) and it is the directory of logs file not mcp configuration file.
However, I found the path %APPDATA%\Warp\mcp.json with default setup on my local Windows machine, and the server configuration works with it. I’ll look for more evidence to confirm this.

Copy link
Contributor

@msanatan msanatan Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do the docs say?

Your confirmation that it works is more important than CodeRabbit's comments

Copy link
Author

@tanthcstt tanthcstt Oct 25, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@msanatan image
image
There’s no official documentation that specifies this directory exactly.
I was only able to test it on my own machine.

};

// Initialize status enums after construction
Expand Down
1 change: 1 addition & 0 deletions MCPForUnity/Editor/Models/McpTypes.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,5 +10,6 @@ public enum McpTypes
VSCode,
Windsurf,
Trae,
Warp
}
}
7 changes: 7 additions & 0 deletions MCPForUnity/Editor/Services/ClientConfigurationService.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -469,6 +469,13 @@ public string GetInstallationSteps(McpClient client)
"4. For local servers, Node.js (npx) or uvx must be installed\n" +
"5. Save and restart Trae",

McpTypes.Warp =>
"1. Open Warp\n" +
"2. Open 'Warp Drive' — click the Warp icon in the top-left corner, or press (Ctrl + Shift + | on Windows / ⌘ + | on macOS)\n" +
"3. Go to MCP Servers > Add\n" +
"4. Paste the configuration JSON\n" +
"5. Save",

_ => "Configuration steps not available for this client."
};

Expand Down
25 changes: 25 additions & 0 deletions UnityMcpBridge/Editor/Data/McpClients.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -206,6 +206,31 @@ public class McpClients
mcpType = McpTypes.Codex,
configStatus = "Not Configured",
},
// Warp
new()
{
name = "Warp",
windowsConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
"Warp",
"mcp.json"
),
macConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
"Library",
"Application Support",
"Warp",
"mcp.json"
),
linuxConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
".config",
"Warp",
"mcp.json"
),
mcpType = McpTypes.Warp,
configStatus = "Not Configured",
},
Comment on lines +209 to +233
Copy link
Contributor

@coderabbitai coderabbitai bot Oct 24, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Verify Warp configuration paths with official documentation.

The configuration paths follow the established pattern used by other clients (e.g., Trae), but it's important to confirm these are the actual paths used by Warp.dev for MCP configuration.

🌐 Web query:

What are the official MCP configuration file paths for Warp terminal?

💡 Result:

Official MCP file locations (per Warp docs):

  • macOS: $HOME/Library/Application Support/dev.warp.Warp-Stable/mcp. [1]
  • Windows (PowerShell): $env:LOCALAPPDATA\warp\Warp\data\logs\mcp. [1]
  • Linux: ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp. [1]

Source: Warp documentation (Model Context Protocol / MCP). [1]

Update Warp MCP configuration paths to match official Warp documentation.

The paths in the code do not match the official Warp MCP locations:

  • Windows: Should be %LOCALAPPDATA%\warp\Warp\data\logs\mcp, not %LOCALAPPDATA%\Warp\mcp.json
  • macOS: Should be $HOME/Library/Application Support/dev.warp.Warp-Stable/mcp, not $HOME/Library/Application Support/Warp/mcp.json
  • Linux: Should be ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp, not $HOME/.config/Warp/mcp.json

Per Warp's official Model Context Protocol documentation, the correct paths are macOS: $HOME/Library/Application Support/dev.warp.Warp-Stable/mcp; Windows: $env:LOCALAPPDATA\warp\Warp\data\logs\mcp; and Linux: ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp.

🤖 Prompt for AI Agents 
In UnityMcpBridge/Editor/Data/McpClients.cs around lines 209 to 233, the Warp
MCP config paths are incorrect; update Windows to
Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
"warp", "Warp", "data", "logs", "mcp"), macOS to
Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
"Library", "Application Support", "dev.warp.Warp-Stable", "mcp"), and Linux to
use the XDG_STATE_HOME env var with fallback to HOME/.local/state (e.g.,
Path.Combine(Environment.GetEnvironmentVariable("XDG_STATE_HOME") ??
Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
".local", "state"), "warp-terminal", "mcp")); leave mcpType and configStatus
as-is.

Copy link
Contributor

@msanatan msanatan Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tanthcstt is this true? Can you show reference the docs for the paths you've added for Window, Mac and Linux? Not in the code, just reply to this comment

Copy link
Contributor

@coderabbitai coderabbitai bot Oct 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

};

// Initialize status enums after construction
Expand Down
1 change: 1 addition & 0 deletions UnityMcpBridge/Editor/Models/McpTypes.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,5 +10,6 @@ public enum McpTypes
VSCode,
Windsurf,
Trae,
Warp,
}
}
8 changes: 8 additions & 0 deletions UnityMcpBridge/Editor/Windows/ManualConfigEditorWindow.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,14 @@ protected virtual void OnGUI()
instructionStyle
);
}
else if (mcpClient?.mcpType == McpTypes.Warp)
{
EditorGUILayout.LabelField(
"a) Open 'Warp Drive' by clicking the Warp icon in the top-left corner or press (Ctrl + Shift + | on Windows / ⌘ + | on macOS) > MCP Servers > Add",
instructionStyle
);
}

EditorGUILayout.LabelField(" OR", instructionStyle);
EditorGUILayout.LabelField(
" b) Opening the configuration file at:",
Expand Down