How to Connect GitLab Remote MCP to Windsurf

Add GitLab's remote MCP server to Windsurf in about a minute.

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1ยทhttps://gitlab.com/api/v4/mcp

Step-by-step

  1. Edit mcp_config.json
    Add the serverUrl config above to ~/.codeium/windsurf/mcp_config.json and refresh in Cascade.
  2. Authorize
    On first use your client opens a GitLab OAuth consent screen โ€” approve it and tools become available.
  3. Verify
    Verify in the browser: paste https://gitlab.com/api/v4/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

  • A 401 Unauthorized on first connect is normal โ€” the endpoint is OAuth-protected; let Windsurf finish the browser consent flow.
  • If the consent window never opens, remove and re-add the server, then retry.
  • Check the exact challenge at our OAuth debugger.
  • Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Streamable HTTPhttps://gitlab.com/api/v4/mcp

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gitlab": {
      "serverUrl": "https://gitlab.com/api/v4/mcp"
    }
  }
}

Tools exposed by GitLab (22)

ToolSafetyDescriptionParameters
mcp_search
~34 tok
๐ŸŸข ReadSearch GitLab projects, issues and merge requests.โ€”
get_project
~30 tok
๐ŸŸข ReadGet details of a GitLab project.โ€”
list_projects
~28 tok
๐ŸŸข ReadList GitLab projects.โ€”
get_file_contents
~31 tok
๐ŸŸข ReadRead a file from a repository.โ€”
get_issue
~26 tok
๐ŸŸข ReadGet a GitLab issue.โ€”
list_issues
~28 tok
๐ŸŸข ReadList issues of a project.โ€”
create_issue
~28 tok
๐ŸŸ  WriteCreate a GitLab issue.โ€”
create_issue_note
~29 tok
๐ŸŸ  WriteAdd a note to an issue.โ€”
get_merge_request
~29 tok
๐ŸŸข ReadGet a merge request.โ€”
list_merge_requests
~32 tok
๐ŸŸข ReadList merge requests of a project.โ€”
create_merge_request
~30 tok
๐ŸŸ  WriteCreate a merge request.โ€”
create_merge_request_note
~33 tok
๐ŸŸ  WriteAdd a note to a merge request.โ€”
get_pipeline
~28 tok
๐ŸŸข ReadGet a CI/CD pipeline.โ€”
list_pipelines
~30 tok
๐ŸŸข ReadList pipelines of a project.โ€”
get_job
~26 tok
๐ŸŸข ReadGet a pipeline job.โ€”
get_milestone
~29 tok
๐ŸŸข ReadGet a project milestone.โ€”
list_milestones
~29 tok
๐ŸŸข ReadList project milestones.โ€”
get_commit
~25 tok
๐ŸŸข ReadGet a commit.โ€”
list_branches
~29 tok
๐ŸŸข ReadList repository branches.โ€”
create_branch
~29 tok
๐ŸŸ  WriteCreate a repository branch.โ€”
list_tags
~27 tok
๐ŸŸข ReadList repository tags.โ€”
run_pipeline
~29 tok
๐ŸŸ  WriteTrigger a CI/CD pipeline.โ€”

Connect GitLab to another client

Other servers for Windsurf

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline261ms
Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~606 tok18 toolsOnline21ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~899 tok30 toolsOnline8ms

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿงฉ MCP App๐Ÿ›ก๏ธ A+~286 tok8 toolsOnline218ms
AWS KnowledgeAmazon Web Services

AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ€” connect and call tools immediately.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline155ms

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~1336 tok43 toolsOnline217ms