Xano Documentation
  • 👋Welcome to Xano!
  • 🌟Frequently Asked Questions
  • 🔐Security & Compliance (Trust Center)
  • 🙏Feature Requests
  • 💔Known Issues
  • Before You Begin
    • Using These Docs
    • Where should I start?
    • Set Up a Free Xano Account
    • Key Concepts
    • The Development Life Cycle
    • Navigating Xano
    • Plans & Pricing
  • The Database
    • Designing your Database
    • Database Basics
      • Using the Xano Database
      • Field Types
      • Relationships
      • Database Views
      • Export and Sharing
      • Data Sources
    • Migrating your Data
      • Airtable to Xano
      • Supabase to Xano
      • CSV Import & Export
    • Database Performance and Maintenance
      • Storage
      • Indexing
      • Maintenance
      • Schema Versioning
  • 🛠️The Function Stack
    • Building with Visual Development
      • APIs
        • Swagger (OpenAPI Documentation)
      • Custom Functions
        • Async Functions
      • Background Tasks
      • Triggers
      • Middleware
      • Configuring Expressions
      • Working with Data
    • Functions
      • AI Tools
      • Database Requests
        • Query All Records
          • External Filtering Examples
        • Get Record
        • Add Record
        • Edit Record
        • Add or Edit Record
        • Patch Record
        • Delete Record
        • Bulk Operations
        • Database Transaction
        • External Database Query
        • Direct Database Query
        • Get Database Schema
      • Data Manipulation
        • Create Variable
        • Update Variable
        • Conditional
        • Switch
        • Loops
        • Math
        • Arrays
        • Objects
        • Text
      • Security
      • APIs & Lambdas
        • Realtime Functions
        • External API Request
        • Lambda Functions
      • Data Caching (Redis)
      • Custom Functions
      • Utility Functions
      • File Storage
      • Cloud Services
    • Filters
      • Manipulation
      • Math
      • Timestamp
      • Text
      • Array
      • Transform
      • Conversion
      • Comparison
      • Security
    • Data Types
      • Text
      • Expression
      • Array
      • Object
      • Integer
      • Decimal
      • Boolean
      • Timestamp
      • Null
    • Environment Variables
    • Additional Features
      • Response Caching
  • Testing and Debugging
    • Testing and Debugging Function Stacks
    • Unit Tests
    • Test Suites
  • CI/CD
  • File Storage
    • File Storage in Xano
    • Private File Storage
  • Realtime
    • Realtime in Xano
    • Channel Permissions
    • Realtime in Webflow
  • Maintenance, Monitoring, and Logging
    • Statement Explorer
    • Request History
    • Instance Dashboard
      • Memory Usage
  • Building Backend Features
    • User Authentication & User Data
      • Separating User Data
      • Restricting Access (RBAC)
      • OAuth (SSO)
    • Webhooks
    • Messaging
    • Emails
    • Custom Report Generation
    • Fuzzy Search
    • Chatbots
  • Xano Features
    • Snippets
    • Instance Settings
      • Release Track Preferences
      • Static IP (Outgoing)
      • Change Server Region
      • Direct Database Connector
      • Backup and Restore
      • Security Policy
    • Advanced Back-end Features
      • Xano Link
      • Developer API (Deprecated)
    • Metadata API
      • Master Metadata API
      • Tables and Schema
      • Content
      • Search
      • File
      • Request History
      • Workspace Import and Export
      • Token Scopes Reference
  • Xano AI
    • Building a Backend Using AI
    • Get Started Assistant
    • AI Database Assistant
    • AI Lambda Assistant
    • AI SQL Assistant
    • API Request Assistant
    • Template Engine
    • Streaming APIs
  • AI Tools
    • MCP Servers
      • Connecting Clients
      • MCP Functions
  • Xano Transform
    • Using Xano Transform
  • Xano Actions
    • What are Actions?
    • Browse Actions
  • Team Collaboration
    • Realtime Collaboration
    • Managing Team Members
    • Branching & Merging
    • Role-based Access Control (RBAC)
  • Agencies
    • Xano for Agencies
    • Agency Features
      • Agency Dashboard
      • Client Invite
      • Transfer Ownership
      • Agency Profile
      • Commission
      • Private Marketplace
  • Enterprise
    • Xano for Enterprise
    • Enterprise Features
      • Microservices
      • Tenant Center
      • Compliance Center
      • Security Policy
      • Instance Activity
      • Deployment
      • RBAC (Role-based Access Control)
      • Xano Link
  • Your Xano Account
    • Account Page
    • Billing
    • Referrals & Commissions
  • Troubleshooting & Support
    • Error Reference
    • Troubleshooting Performance
      • When a single workflow feels slow
      • When everything feels slow
      • RAM Usage
      • Function Stack Performance
    • Getting Help
      • Granting Access
      • Community Code of Conduct
      • Community Content Modification Policy
  • Special Pricing
    • Students & Education
    • Non-Profits
  • Security
    • Best Practices
Powered by GitBook
On this page
  • Cursor
  • Cursor (per-project)
  • Claude Desktop
  • Windsurf
  • FAQ and Troubleshooting

Was this helpful?

  1. AI Tools
  2. MCP Servers

Connecting Clients

Last updated 12 days ago

Was this helpful?

Cursor

The below instructions will allow you to connect your Xano MCP server to Cursor and make them available across any project. The below method does not support authentication. If you need authentication or want to define per-project MCPs, use these instructions instead.

1

Open your Cursor settings

2

Under the Features subsection, scroll down to MCP Servers

3

Click + Add new MCP Server

Give your server a name.

The type should be sse

Paste your server URL in the Server URL section. You can retrieve your server URL by navigating to your server in Xano and clicking Copy Connection URL.

4

You should now see your MCP Server ready in Cursor

5

In your chat window, you can now interact with the tools included in your MCP server that's connected

Make sure the conversation type is set to Agent

In our example, we have a tool that checks if a user is marked as an administrator.

Cursor (per-project)

Please note that Cursor does not currently support authentication headers for SSE connections. You can only use tools that do not require authentication.

1

In your project's root directory, create a new folder called .cursor

2

Create a new file inside of that folder called mcp.json

3

Fill out the required details inside of mcp.json

If the file is blank, start with the basic structure and replace the placeholder values with your own.

{
  "mcpServers": {
    "YOUR SERVER NAME HERE": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR CONNECTION URL HERE"
      ]
    }
  }
}

You can add multiple entries if you have multiple MCP servers. See the below example.

{
  "mcpServers": {
    "xano_development": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_production": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_tools": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    }
  }
}
4

Restart Cursor.

In your chat window, you can now interact with the tools included in your MCP server that's connected

Make sure the conversation type is set to Agent

In our example, we have a tool that checks if a user is marked as an administrator.


Claude Desktop

1

Install the prerequisites

You need Node.js installed on your system.

Download the latest installer from the for your specific platform.

2

Open Claude Desktop's config file in your text / code editor of choice

  • Mac OS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

3

Add an entry in the config file for your Xano MCP server

Click Edit Config and in the window that opens, open claude_desktop_config.json in your favorite text or code editor.

If the file is blank, start with the basic structure and replace the placeholder values with your own.

{
  "mcpServers": {
    "YOUR SERVER NAME HERE": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR CONNECTION URL HERE"
      ]
    }
  }
}

If any of your tools require authentication, you can add that to your config file. See the below example.

{
  "mcpServers": {
    "xano": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR CONNECTION URL HERE",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR AUTH TOKEN HERE"
      }
    }
  }
}

You can add multiple entries if you have multiple MCP servers. See the below example.

{
  "mcpServers": {
    "xano_development": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_production": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_tools": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    }
  }
}
4

Relaunch Claude Desktop to interact with your MCP server(s)

In Claude, you should see a new icon under your chat box with a icon.

You can click on this to view information about your available tools.


Windsurf

1

Head to your Windsurf settings

2

Click Cascade, and then Add Server

3

Click 'Add Custom Server'

4

Fill out the config file with your MCP server details

If the file is blank, start with the basic structure and replace the placeholder values with your own.

{
  "mcpServers": {
    "YOUR SERVER NAME HERE": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR CONNECTION URL HERE"
      ]
    }
  }
}

If any of your tools require authentication, you can add that to your config file. See the below example.

{
  "mcpServers": {
    "xano": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR CONNECTION URL HERE",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR AUTH TOKEN HERE"
      }
    }
  }
}

You can add multiple entries if you have multiple MCP servers. See the below example.

{
  "mcpServers": {
    "xano_development": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_production": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    },
    "xano_tools": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "CONNECTION URL HERE"
      ]
    }
  }
}
5

Click the Refresh button, and you should see your MCP server(s) available


FAQ and Troubleshooting

How do I use my MCP server in one of these clients?

Once you're connected following the instructions above, you should be able to converse with the AI like you would any other, asking real-world questions that the tools you built should be able to answer.

For example, if we have a tool that just returns a true or false, we'd probably be asking yes or no questions, such as "Does this user, john@email.com, have administrator access?"

I can't connect to my server from my client of choice.

Check the error message you're receiving for clues. This could be due to one of the following:

  • An incorrectly formatted configuration file

  • Your Xano MCP Server is not set to allow connections

  • You're not providing an authentication token to a server that requires it

For MCP servers with tools that require authentication, after a long waiting period, I get a connection error.

In our current testing, we are finding that running multiple MCP clients causes this issue. Our recommendation is to stick with a single client for the time being.

Try these steps:

  • Close any open MCP clients

  • Ensure that your authentication token is not expired

  • On Mac, run

    rm -rf ~/.mcp-auth
  • Restart your MCP client and try connecting again

🛠️
Node.js official website
An example of using a Xano MCP server in Claude Desktop