Getting Started

Connection

Connect AI assistants to your MCP server and add install buttons to your documentation.

Overview

Once your MCP server is running, you can connect AI assistants like Cursor, VS Code, and ChatGPT to use your tools, resources, and prompts.

The module also provides components and routes to help your users install your MCP server in one click.

Connect Your IDE

Cursor

Click the button below to add your local MCP server to Cursor:

Install MCP in Cursor

Or manually add it to your Cursor settings (~/.cursor/mcp.json):

~/.cursor/mcp.json
{
  "mcpServers": {
    "my-nuxt-app": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

VS Code

Click the button below to add your local MCP server to VS Code:

Install MCP in VS Code

Or manually add the server to your VS Code MCP configuration (.vscode/mcp.json):

.vscode/mcp.json
{
  "servers": {
    "my-nuxt-app": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}
Replace my-nuxt-app with your project name and update the URL if you're using a custom route or port.

InstallButton Component

The module provides an InstallButton component that you can use in your documentation to let users install your MCP server in one click.

Supported IDEs

IDEValueStatus
CursorcursorSupported
VS CodevscodeSupported

In Vue Templates

<template>
  <!-- Cursor (default) -->
  <InstallButton url="https://my-app.com/mcp" />

  <!-- VS Code -->
  <InstallButton url="https://my-app.com/mcp" ide="vscode" />

  <!-- Custom label -->
  <InstallButton url="https://my-app.com/mcp" label="Add to Cursor" />
</template>

In Markdown (MDC Syntax)

If you're using Nuxt Content, use the MDC syntax:

<!-- Cursor (default) -->
::install-button
---
url: "https://my-app.com/mcp"
---
::

<!-- VS Code -->
::install-button
---
url: "https://my-app.com/mcp"
ide: "vscode"
---
::

<!-- With custom label -->
::install-button
---
url: "https://my-app.com/mcp"
label: "Add to Cursor"
---
::

Props Reference

PropTypeDefaultDescription
urlstringrequiredURL of the MCP server endpoint
ide'cursor' | 'vscode''cursor'Target IDE
labelstringAuto-generatedButton label
showIconbooleantrueShow the IDE icon

Customization

The component uses CSS classes that you can override:

/* Override default styles */
.mcp-install-button {
  background-color: #your-brand-color;
  border-radius: 9999px;
}

Or use the slot for completely custom content:

<InstallButton url="https://my-app.com/mcp">
  Add to Cursor
</InstallButton>

README Badge

For README files and documentation outside of Vue/Nuxt, the module provides server routes to generate badges.

Badge Routes

The module exposes two routes:

RouteDescription
/mcp/deeplinkRedirects to the IDE deeplink
/mcp/badge.svgReturns a customizable SVG badge image

Basic Usage

Add this to your README:

[![Install in Cursor](https://your-app.com/mcp/badge.svg)](https://your-app.com/mcp/deeplink)

This will display a badge that, when clicked, opens the IDE and installs your MCP server.

VS Code Badge

[![Install in VS Code](https://your-app.com/mcp/badge.svg?ide=vscode)](https://your-app.com/mcp/deeplink?ide=vscode)

Both IDEs

[![Install in Cursor](https://your-app.com/mcp/badge.svg)](https://your-app.com/mcp/deeplink)
[![Install in VS Code](https://your-app.com/mcp/badge.svg?ide=vscode)](https://your-app.com/mcp/deeplink?ide=vscode)

Customization Options

ParameterDefaultDescription
idecursorTarget IDE (cursor or vscode)
labelAuto-generatedBadge text
color171717Background color (hex without #)
textColorffffffText color (hex without #)
borderColor404040Border color (hex without #)
icontrueShow IDE icon (true or false)

Custom Badge Examples

Custom label:

[![Add to Cursor](https://your-app.com/mcp/badge.svg?label=Add%20to%20Cursor)](https://your-app.com/mcp/deeplink)

Custom colors:

[![Install](https://your-app.com/mcp/badge.svg?color=0ea5e9&borderColor=0284c7)](https://your-app.com/mcp/deeplink)

Without icon:

[![Install](https://your-app.com/mcp/badge.svg?icon=false)](https://your-app.com/mcp/deeplink)
Replace https://your-app.com with your actual domain. The badge route uses the server name from your mcp.name config.

For reference, here are the deeplink formats used by each IDE:

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=SERVER_NAME&config=BASE64_CONFIG

The config is Base64-encoded JSON containing { type: 'http', url: 'MCP_URL' }.

VS Code

vscode:mcp/install?URL_ENCODED_JSON

The config is URL-encoded JSON containing { name: 'SERVER_NAME', type: 'http', url: 'MCP_URL' }.

Next Steps

  • Tools - Create your first tool
  • Resources - Expose data to AI assistants
  • Prompts - Create reusable message templates