Client Setup Guide

April 21, 2026 · View on GitHub

Connect Lara Translate to your favorite AI client. The recommended method uses OAuth — just enter the server URL and log in through your browser. No API keys to manage.

Table of Contents

Claude Desktop

  1. Open Claude Desktop and go to Settings > Connectors
  2. Click Add Custom Connector
  3. Enter the name: Lara
  4. Enter the URL: https://mcp-v2.laratranslate.com/v1
  5. Click Add
  6. Click Connect next to the connector. Your browser will open the Lara Translate login page.
  7. Log in with your Lara Translate credentials. You'll be redirected back to Claude Desktop automatically.

That's it — Lara Translate is now available in your conversations.

For more on custom connectors, see the Claude documentation.

Cursor

The recommended install is via the Cursor plugin marketplace: open the plugin browser, search for Lara Translate, and click Install. The first tool call opens your browser to authenticate.

Alternatively, configure the MCP server manually:

  1. Open the MCP config file:

    • macOS: ~/.cursor/mcp.json
    • Windows: %APPDATA%\Cursor\mcp.json
    • Linux: ~/.cursor/mcp.json

  2. Paste:

{
  "mcpServers": {
    "lara-translate": {
      "url": "https://mcp-v2.laratranslate.com/v1"
    }
  }
}
  1. Save and restart Cursor.
  2. The first time you use a Lara tool, Cursor will open your browser to authenticate with your Lara Translate credentials.

Claude Code

Run this command in your terminal:

claude mcp add lara-translate --transport http --url https://mcp-v2.laratranslate.com/v1

The first time Lara tools are used, Claude Code will open your browser to authenticate with your Lara Translate credentials.

Alternatively, create a .mcp.json file in your project root:

{
  "mcpServers": {
    "lara-translate": {
      "type": "http",
      "url": "https://mcp-v2.laratranslate.com/v1"
    }
  }
}

VS Code (GitHub Copilot)

VS Code supports MCP servers through GitHub Copilot's agent mode.

Option A: Project-level config

Create a .vscode/mcp.json file in your project:

{
  "servers": {
    "lara-translate": {
      "type": "http",
      "url": "https://mcp-v2.laratranslate.com/v1"
    }
  }
}

Option B: User settings

Open VS Code Settings (JSON) and add:

{
  "mcp": {
    "servers": {
      "lara-translate": {
        "type": "http",
        "url": "https://mcp-v2.laratranslate.com/v1"
      }
    }
  }
}

Save and reload VS Code. When you first use a Lara tool in Copilot's agent mode, your browser will open to authenticate with Lara Translate.

MCP support in VS Code requires GitHub Copilot. See the VS Code MCP documentation for details.

Windsurf

  1. Open the config file:

    • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
    • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

    Or in Windsurf: Settings > search "MCP" > Edit in mcp_config.json.

  2. Paste:

{
  "mcpServers": {
    "lara-translate": {
      "serverUrl": "https://mcp-v2.laratranslate.com/v1"
    }
  }
}
  1. Save and restart Windsurf. Your browser will open to authenticate the first time you use a Lara tool.

Cline (VS Code)

  1. Open VS Code and click the Cline icon in the sidebar.
  2. Click the MCP Servers button (server icon) at the top of the Cline panel.
  3. Click Remote Servers.
  4. Add:
{
  "mcpServers": {
    "lara-translate": {
      "url": "https://mcp-v2.laratranslate.com/v1"
    }
  }
}
  1. Save. Your browser will open to authenticate when you first use a Lara tool.

Continue

  1. Open the config file:

    • macOS / Linux: ~/.continue/config.json
    • Windows: %USERPROFILE%\.continue\config.json

    Or use the Continue sidebar > gear icon.

  2. Add the mcpServers section:

{
  "mcpServers": [
    {
      "name": "lara-translate",
      "url": "https://mcp-v2.laratranslate.com/v1"
    }
  ]
}
  1. Save and restart Continue. Your browser will open to authenticate when you first use a Lara tool.

Note: Continue uses an array format for mcpServers. See the Continue MCP docs for details.

Alternative: Access Key Authentication

If your client doesn't support OAuth, or you prefer to authenticate with API keys instead of browser login, you can pass your credentials directly in the config. Get your Access Key ID and Secret from Lara Translate.

Clients with url support (Cursor, Windsurf, VS Code, Cline, Continue, Claude Code)

Add your credentials as headers alongside the URL:

{
  "lara-translate": {
    "url": "https://mcp-v2.laratranslate.com/v1",
    "headers": {
      "x-lara-access-key-id": "<YOUR_ACCESS_KEY_ID>",
      "x-lara-access-key-secret": "<YOUR_ACCESS_KEY_SECRET>"
    }
  }
}

Adapt the wrapper format to your client (e.g., "mcpServers" for Cursor, "servers" with "type": "http" for VS Code, etc.). See the OAuth sections above for each client's exact format.

Claude Desktop (command-based)

Claude Desktop doesn't support url-based configs directly, so it uses mcp-remote as a bridge. Requires Node.js.

Open the config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Paste:

{
  "mcpServers": {
    "lara-translate": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-v2.laratranslate.com/v1",
        "--header",
        "x-lara-access-key-id: ${X_LARA_ACCESS_KEY_ID}",
        "--header",
        "x-lara-access-key-secret: ${X_LARA_ACCESS_KEY_SECRET}"
      ],
      "env": {
        "X_LARA_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "X_LARA_ACCESS_KEY_SECRET": "<YOUR_ACCESS_KEY_SECRET>"
      }
    }
  }
}

Replace the placeholders with your credentials, save, and restart Claude Desktop.

Troubleshooting

OAuth login page doesn't open?

  • Ensure your client supports OAuth for MCP servers (check your client's documentation)
  • Make sure your default browser is set and can open URLs
  • Try the Access Key method as a fallback

Server not showing up after restart?

  • Double-check your JSON syntax (missing commas, trailing commas, etc.)
  • Ensure the config file is in the correct location for your OS
  • Some clients require a full application restart, not just a window reload

Authentication errors?

  • If using Access Key: verify your credentials are correct and active in your Lara Translate account
  • If using OAuth: try disconnecting and reconnecting to re-authenticate

Connection issues with mcp-remote?

  • Ensure Node.js (v18+) is installed: node --version
  • Check your network/firewall allows outbound HTTPS connections

Still stuck?