Chat app · Anthropic

Claude Desktop + Tintly

Ask Claude about colors, with Tintly behind it.

  • Claude Desktop
  • Node.js (for npx)
  • A Tintly API key

Connect Claude Desktop in three steps

Claude Desktop starts local MCP servers from a config file. Tintly is a remote server, so the config uses the small mcp-remote bridge, which sends your key in the Authorization header.

  1. 1

    Create an API key

    Sign in on the developer page and create a key.

  2. 2

    Open the config file

    In Claude Desktop open Settings, then Developer, then Edit Config. This opens claude_desktop_config.json.

  3. 3

    Add Tintly and restart

    Paste the block below into the file (merge it into mcpServers if you already have servers), save, and restart Claude Desktop.

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "tintly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.trycolorkit.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

The key sits in env, with no space in the header argument: this is the usual workaround for spaces in arguments on Windows.

Server address: https://www.trycolorkit.com/api/mcp. Replace YOUR_API_KEY with a key from the developer page. Field names can change between releases of Claude Desktop: if one is rejected, follow its current MCP docs, which only need the address and the Authorization header.

What you need

  • Claude Desktop
  • Node.js (for npx)
  • A Tintly API key

Good to know

  • Config location: macOS ~/Library/Application Support/Claude, Windows %APPDATA%\Claude.
  • Keep the file private: it now holds your key.

First things to ask Claude Desktop

  • Make me a calm, trustworthy palette for a banking app and check the text contrast.
  • Which pairs in #0B132B, #1C2541, #5BC0DE, #F4D6B0 and #D97706 are readable as text?
  • Explain what the color #2A9D8F says to people, and where it works best.

Questions about Claude Desktop and Tintly

Can I use the Connectors screen instead?

Custom connectors in the Claude apps are set up differently from this key-based setup. Use the config file above, which works today with an API key.

Do I need an API key?

Yes. Every request carries your key in the Authorization header. Create one on the developer page: it is free and takes a few seconds.

Can an assistant change my account or my saved palettes?

No. Every Tintly tool only reads or computes: palettes, colors, contrast and descriptions. Nothing here writes to your library or account.

What does it cost?

Nothing. Tintly is free, and so are the API and the MCP server. Each key is limited to 60 requests a minute so it stays fast for everyone.