Connect Windsurf

Add Terno AI to Windsurf's Cascade agent as a remote MCP server.

Use Terno from the Cascade agent in Windsurf.

Server URL: https://mcp.terno.ai/mcp

Preview server URL: https://mcp.terno.ai/mcp/preview (adds app connectors such as Google Ads and GA4)

Before you start

Windsurf installed.
A Terno AI account. You don’t need to sign up first: when you connect, Terno takes you to sign up if you don’t have an account, or to sign in if you’re signed out, and then shows the consent screen.
No data source is needed to connect. Ask your assistant to connect one and Terno gives it a link where you add the connection details in Terno. You can also add one in the app; see Connectors.

Connect Terno

In the Cascade panel, click the ⋯ menu at the top right.
In the MCPs section, click Open MCP config file.

Add Terno under mcpServers:

{
  "mcpServers": {
    "terno": { "serverUrl": "https://mcp.terno.ai/mcp" }
  }
}

For the preview server (app connectors such as Google Ads and GA4), use this instead:

{
  "mcpServers": {
    "terno-preview": { "serverUrl": "https://mcp.terno.ai/mcp/preview" }
  }
}

Save the file, then switch terno on in the MCPs section.
If you’re asked to authorize, sign in to Terno.

Check it works

Ask your assistant something like:

“Which data sources do I have in Terno?”
“Using Terno, show the top 10 customers by revenue this year.”

It should call Terno’s tools and answer from your data.

App connectors (preview)

The main server works with your databases and warehouses. To also use app connectors such as Google Ads and GA4, add the preview server in the same way, using https://mcp.terno.ai/mcp/preview. It will come to the main server soon.

Troubleshooting

The sign-in window doesn’t open, or sign-in fails

Complete the sign-in in the browser window or tab your assistant opens, using your Terno account. If it times out, start the connection again.

Terno’s tools don’t show up

Check the server URL is exactly https://mcp.terno.ai/mcp (or https://mcp.terno.ai/mcp/preview for the preview server), and that the Terno server is switched on in your assistant.

”No data sources” or empty answers

Connect a data source in Terno first. The assistant only sees what’s connected in your Terno workspace, within your access rules.

Disconnect

Remove the Terno connector or server in your assistant.