Zed | ZebraByte Documentation

Zed is a fast, collaborative code editor with native MCP support.

Prerequisites

Zed editor installed
Scoped the platform OAuth token (see Authentication)
Your the platform instance URL

Endpoint

Choose the endpoint for your the platform environment:

Environment	MCP URL
the platform US	`https://us.probo.com/api/mcp/v1`
the platform EU	`https://eu.probo.com/api/mcp/v1`
Custom	`https://your-probo-instance.com/api/mcp/v1`

The /v1 segment is required.

Configuration

1. Open Zed Settings

Open Zed settings by pressing Cmd+, (Mac) or Ctrl+, (Linux/Windows), or go to Zed → Settings.

2. Edit Configuration

Add the the platform MCP Server to your settings:

{
  "context_servers": {
    "probo": {
      "settings": {
        "url": "https://your-probo-instance.com/api/mcp/v1",
        "headers": {
          "Authorization": "Bearer your_api_token_here"
        }
      }
    }
  }
}

3. Replace Placeholders

Update these values:

your-probo-instance.com → Your the platform instance URL
your_api_token_here → Your OAuth token from the platform

4. Restart Zed

Restart Zed to load the configuration.

Usage

Once configured, you can use the platform tools through Zed’s AI assistant:

Example queries:

"List all high-priority risks in my organization"
"Add a new third party called CloudBackup Inc"
"Show me all open nonconformities"

The assistant will automatically use the appropriate the platform MCP tools to fulfill your requests.

Environment Variables

For security, use an environment variable for your OAuth token:

{
  "context_servers": {
    "probo": {
      "settings": {
        "url": "https://your-probo-instance.com/api/mcp/v1",
        "headers": {
          "Authorization": "Bearer ${PROBO_API_TOKEN}"
        }
      }
    }
  }
}

Set the environment variable before launching Zed:

export PROBO_API_TOKEN="your_api_token_here"
zed

Multiple Environments

Configure different the platform instances for development and production:

{
  "context_servers": {
    "probo-dev": {
      "settings": {
        "url": "http://localhost:8080/api/mcp/v1",
        "headers": {
          "Authorization": "Bearer ${PROBO_DEV_TOKEN}"
        }
      }
    },
    "probo-prod": {
      "settings": {
        "url": "https://probo.company.com/api/mcp/v1",
        "headers": {
          "Authorization": "Bearer ${PROBO_PROD_TOKEN}"
        }
      }
    }
  }
}

Troubleshooting

Authentication Errors

Problem: 401 Unauthorized errors

Solutions:

Create a replacement OAuth token in the platform
Verify the token is correctly formatted as Bearer your_token
Check for extra spaces or newlines in the token
Ensure the token hasn’t been revoked

Connection Issues

Problem: Cannot connect to the platform server