Connect Windsurf to the tools your team uses

Windsurf's Cascade agent calls tools through MCP. Point it at Metorial and it can read issues, docs and data from the apps your team approves, with access scoped to each developer.

OAuth
Scopes
RBAC
Audit
Windsurf

One connection

Give Windsurf one link to every tool

Point Windsurf at a single Metorial endpoint and it can reach every integration and internal system you approve. Set up once, not per tool, and keep your credentials secure.

One Magic MCP URL

Windsurf connects through a single governed Magic MCP url instead of wiring up servers by hand.

  • Connect once, not per tool
  • No credentials to manage in the agent
  • New integrations appear automatically

Works with Windsurf as-is

Connect Windsurf the way you already use it, with no change to how the agent is built or run.

  • MCP-compatible out of the box
  • 1,000 first-party integrations
  • Native workflows through the CLI

Validated, maintained connections

Every provider is first-party and maintained, validated, and updated by Metorial.

  • Maintained provider connections
  • Tools and data in one catalog
  • Kept current as APIs change

Connect Windsurf to Metorial

Everyone uses their own Magic MCP URL and signs in with SSO. No API keys go into config files.

  1. Add the server. Open Settings, then Tools, then Windsurf Settings, and select Add Server. Or choose View Raw Config and add Metorial to mcp_config.json.
    {
    "mcpServers": {
    "metorial": {
    "serverUrl": "<your-magic-mcp-url>"
    }
    }
    }
  2. Expose the tools to Cascade. Select Metorial in the server list and choose Add Server so Cascade can use its tools.
  3. Sign in. Sign in with your company account when Cascade asks, then your tools are available.

If something doesn't work

Metorial does not appear after editing the file
Open the file from View Raw Config so you edit the one Windsurf reads, keep it valid JSON, then refresh the MCP servers in Cascade.
The server is added but Cascade never uses it
Click the server and choose Add Server; tools are only exposed to Cascade once added.
You need to keep a value out of the file
mcp_config.json supports ${env:NAME} interpolation in serverUrl and headers.

Based on the Windsurf MCP documentation.

Popular integrations for Windsurf

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

Vercel

Manage web application deployments, projects, and infrastructure on Vercel's cloud platform. Create and configure projects with build settings, framework presets, and Git repository connections. Deploy applications programmatically, promote deployments to production, and manage rolling releases. Register, transfer, and configure domains with DNS records and SSL certificates. Create and manage environment variables scoped to production, preview, or development environments. Manage team members, roles, and access groups for fine-grained RBAC. Configure Edge Config stores for ultra-low-latency key-value data at the edge. Set up log drains to forward logs to external services. Register deployment checks for custom validation before promotion. Create deploy hooks to trigger builds from external systems. Upload and manage files with Vercel Blob storage. Configure Web Application Firewall rules, rate limiting, and IP blocking. Schedule cron jobs and retrieve billing and usage information. Receive webhooks for deployment lifecycle, domain changes, project events, rolling releases, and marketplace billing activity.

Supabase

Manage PostgreSQL databases, authenticate users, store files, and run edge functions on Supabase. Perform CRUD operations on database tables via auto-generated REST and GraphQL APIs with row-level security. Create and manage user accounts with password, magic link, OTP, social login, and SSO authentication. Upload, download, list, and delete files organized in storage buckets. Deploy and invoke server-side TypeScript edge functions. Listen to realtime database changes, broadcast messages, and track user presence. Configure database webhooks for INSERT, UPDATE, and DELETE events. Programmatically manage Supabase organizations and projects, including creating/deleting projects, managing API keys, configuring auth settings, custom domains, network restrictions, and Edge Function secrets.

Postgresql

Query, insert, update, and delete data in PostgreSQL relational databases. Explore schemas and tables, manage schemas, tables, indexes, views, materialized views, and database roles, and poll tables for row changes using timestamp or incrementing columns.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Figma

Access and inspect Figma design files, including full node trees, layers, properties, and metadata. Export file nodes as PNG, SVG, JPG, or PDF images. Read, create, and delete comments and reactions on files. Manage file version history. List team projects and project files. Retrieve published components, component sets, and styles from team libraries. Create, update, and delete variables and variable collections (Enterprise). Manage dev resources attached to file nodes. Retrieve library analytics and design system usage data (Enterprise). Read organization activity logs and discovery text events (Enterprise). Configure webhooks to receive notifications for file updates, deletions, version changes, comments, library publishes, and dev mode status changes.

Make Windsurf ready for your whole team

After the first connection, teams still need controls. Metorial gives Windsurf a unified workforce portal, your team's knowledge, scoped access, and a security layer around every call.

Workforce

A unified portal for your team

Portals give every team a simple sign-in to connect Windsurf, with no setup work or shared credentials.

Explore Portals

Knowledge

Attach your team's knowledge

Skills package your team's context and workflows so Windsurf acts with the knowledge your team relies on.

Explore Skills

Governance

Scope access by user, tool, and provider

Access control sets policies for who can use which providers and which tools Windsurf is allowed to call.

See Access Control

Security

Check risky calls before they run

Protoguard reviews agent traffic for prompt injection and risky actions before it reaches connected systems.

Explore Protoguard

Frequently asked questions

Common questions about connecting Windsurf to your tools with Metorial.

  1. How do I connect Windsurf to my tools with Metorial?
    Point Windsurf at Metorial through Magic MCP and it can use every integration and internal system you approve. There is no per-tool setup and no change to how Windsurf is built.
  2. Yes. Metorial is MCP compatible, so Windsurf connects through one governed Magic MCP url instead of wiring up servers by hand.
  3. Windsurf can reach 1,000 validated, first-party integrations for the tools teams already use, with new providers added regularly.
  4. Yes. When an off-the-shelf integration does not exist yet, expose your own systems as custom providers and Windsurf reaches them the same way.
  5. Yes. Skills package your team's context and workflows so Windsurf acts with the knowledge your team relies on, not just generic tool access.
  6. Access control lets you set policies across users, groups, tools, and providers, so Windsurf gets exactly the access it should and nothing more.
  7. Protoguard inspects agent traffic for prompt injection and risky calls before they reach your systems, and every action stays traced.
  8. Yes. Portals give any team a simple sign-in to connect Windsurf, with no setup or credentials to manage.

Give Windsurf the tools your team relies on

Connect Windsurf to the systems your teams use, with controls security and operations teams can trust.