Claude (Web & Desktop)

Connect Links MCP to Claude using Custom Connectors or mcp-remote.

This guide explains how to connect Claude to the Links MCP Server. By connecting the systems, Claude can securely access your published data sources and accounting workflows.

New Feature

Claude now supports Custom Connectors natively. This is the recommended, no-code way to connect your workspace. For users who prefer the legacy terminal method on desktop, the Local Config File method is still available.


Prerequisites

Before starting, ensure you have the following:

1
Claude Account
Use the Claude Web app, or download the Claude Desktop App.
2
Links MCP Key
You need your API Key to authenticate. Get your MCP Key here.
3
Node.js Installed
(Required only for the Local Config File method). Verify with node -v. Download Node.js

Configuration

Choose your preferred setup method below. We highly recommend using the Custom Connector.

Open Claude Connectors

  1. Open Claude (Web or Desktop).
  2. Click on your profile name in the navigation bar and select Settings.
  3. Navigate to the Connectors tab.
Connectors Menu

Add Custom Connector

  1. Click the Add custom connector button in the top right.
  2. In the modal, enter a Name for your connector (e.g., "Links Finance Hub").
  3. In the Remote MCP Server URL field, paste the following link, replacing <YOUR_MCP_KEY> with your actual key. (If you skipped the prerequisites, refer to the Links MCP Key section above to retrieve it):
https://dev-backend.thelinks.ai/api/v1/mcp?apiKey=<YOUR_MCP_KEY>

Leave the OAuth toggle disabled. We authenticate securely via the token in the URL.

Filled Connector Modal
  1. Click Add.

Leave the OAuth toggle disabled. We authenticate securely via the token in the URL.

Filled Connector Modal
  1. Click Add.

Configure Tool Permissions

Once added, your new connector will appear in the list.

  1. Click Configure next to the connector.
  2. Set your preferred permissions for each available tool (e.g., Needs Approval, Always Allow, or Block). Note: Tools depend on your published Inbound Connections.
Configure Tool Permissions

Open Config File

You can open the configuration file directly through the Claude app or manually via terminal.

  1. Open Claude Desktop.
  2. Navigate to Settings at User Profile navigation bar. Navigate to Setting
  3. Go to the Developer tab -> Edit Config.
Navigate to edit config
  1. This will open claude_desktop_config.json in your default text editor (VS Code, Notepad, etc.).

Run the following command to open the file in VS Code (or your default editor):

macOS

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

code %APPDATA%\Claude\claude_desktop_config.json

Copy and paste the configuration below into your mcpServers block. We use mcp-remote to handle the HTTPS connection and Authorization header.

claude_desktop_config.json
{
  "mcpServers": {
    "links-finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "[https://dev-backend.thelinks.ai/api/v1/mcp](https://dev-backend.thelinks.ai/api/v1/mcp)",
        "--header",
        "Authorization: Bearer <YOUR_MCP_KEY_OR_BEARER_TOKEN>"
      ]
    }
  }
}

Important

Replace <YOUR_MCP_KEY_OR_BEARER_TOKEN> with your actual key (e.g., 8d4e...-sandbox). Note: Do not remove the word Bearer before your key.

Restart Claude

Save the file and fully quit Claude Desktop, then open it again.

Verify Status

  • Settings: Go back to Settings > Developer. You should see the links-finance server listed with a blue "running" status.
MCP Running Status

Test the Connection

Once you have configured the connection using either method, follow these steps to verify it works.

Check the Input Bar

Click the Connectors (🔌) icon in the chat input area. Ensure links-finance (or your custom connector name) is listed and enabled.

MCP Activated Status

Run a Test Prompt

Type the following prompt to validate that the tool can fetch real data:

Can you get me chart of account cash detail from links-finance mcp?

Prompt Run example

Troubleshooting (Local Config Only)

If the connection fails or the plug icon remains orange/red when using the Local Config method:

1. Check Syntax

Ensure your JSON is valid. A common mistake is leaving a trailing comma after the last item in the list, or missing quotes.

2. Verify MCP Key

Ensure you haven't accidentally deleted the word Bearer inside the header string.

  • Bad: "Authorization: 123-abc"
  • Good: "Authorization: Bearer 123-abc"

On this page