Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shingleai.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through connecting the ShingleAI MCP server to Windsurf, allowing Cascade (Windsurf’s AI) to access your contacts, messages, and other business data.

​
Prerequisites

Before you begin, ensure you have:
  • Windsurf installed
  • A ShingleAI account

​
Connect

Windsurf supports streamable-HTTP MCP servers and runs the OAuth 2.1 + PKCE handshake for you.
  1. Add ShingleAI to ~/.codeium/windsurf/mcp_config.json: 
    {
    "mcpServers": {
        "shingleai": {
            "serverUrl": "https://mcp.shingleai.com/mcp"
        }
    }
}
    Or, from Windsurf, open the Command Palette with Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux), run Open Windsurf Settings, navigate to Cascade → Plugins, and add ShingleAI as a custom MCP plugin pointing at https://mcp.shingleai.com/mcp — Windsurf writes the same JSON.
  2. Restart Windsurf.
  3. The first time Cascade uses a ShingleAI tool — or when you click Connect in the plugin entry — Windsurf opens a browser tab for OAuth.
  4. Sign in to ShingleAI and approve the consent screen. Cascade then has access to the tools you granted.
See Authentication for details on the OAuth handshake.

​
Verification

To verify the connection is working:
  1. Open Cascade (Windsurf’s AI assistant)
  2. Ask: “What ShingleAI tools do you have access to?”
  3. Cascade should list the available tools

​
Example Usage

Once connected, you can use ShingleAI tools in Cascade:
TaskExample Prompt
Find contact info”Look up contact information for our vendor”
Search communications”Find messages mentioning the deployment issue”
View thread”Show the full conversation thread with support”

​
Troubleshooting

Possible causes:
  • Configuration file in wrong location
  • Invalid JSON syntax
  • Windsurf not restarted
Solutions:
  1. Verify the file is at ~/.codeium/windsurf/mcp_config.json
  2. Validate your JSON syntax
  3. Completely restart Windsurf
If the OAuth browser tab fails to load, check that you can reach https://mcp.shingleai.com/.well-known/oauth-protected-resource from your machine.If Cascade shows a stale token error, remove the shingleai entry from ~/.codeium/windsurf/mcp_config.json, restart Windsurf, and re-add it — that forces a fresh Dynamic Client Registration.See Authentication for the underlying flow.
Cascade has a limit of 100 total tools. If you have many MCP servers configured, you may need to disable some tools.Solution:
  1. Open Windsurf Settings, navigate to Cascade → Plugins
  2. Navigate to the Tools tab
  3. Toggle off tools you don’t need

​
Next Steps

Available Tools

Explore all available MCP tools

Authentication

Learn about MCP server authentication
Last modified on May 2, 2026