Step 1: Open the Zed interface
- Launch the Zed app on your system.
- Log in with your account if required.
Step 2: Access MCP settings
- Open the Agent panel ().
- In the Toggle Agent Menu (the three points …), click Settings.
- In section Model Context Protocol (MCP) Servers click
+ Add Server. - Select Add Custom Server.
Step 3: Add Timbal as a new MCP server
- A popup titled Add MCP Server will appear.
- In the bottom-left corner, click Configure Remote.
- Add the Timbal MCP URL (
https://api.timbal.ai/mcp). For example, you can name the server"timbal-mcp":Add MCP ServerZed currently supports authentication using API Keys only. OAuth authentication is not supported for MCP connections in Zed. - Click Add Server to save the configuration.
Step 4: Verify the connection
- You can see in the right the Settings the MCP Servers the tools available in green.
- Click the gear icon next to the server to view the list of available tools.
Step 5: Start using Timbal in Windsurf
- Open the Agent panel.
- Start a new chat.
- You can now use Timbal tools in your conversation. Zed will automatically leverage the MCP integration.
You will be prompted in the chat to confirm before running a Timbal MCP tool. Make sure to accept the request to allow the tool to execute.