Skip to content
Skills Library
AI & agents · Tool integration

connect

/connect

Connect Claude Code to Surface AI, or fix the connection. Use when the user has just installed the Surface AI plugin, when the surface MCP server's tools are missing, or when /mcp shows the surface server failed (for example a 401 or "Missing or invalid management key"). Not for adding a surface to a page — that's the surfaces skill.

Licence
MIT
Last repository change
05.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 05.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Connect Claude Code to Surface AI, or fix the connection. Use when the user has just installed the Surface AI plugin, when the surface MCP server's tools are missing, or when /mcp shows the surface server failed (for example a 401 or "Missing or invalid management key"). Not for adding a surface to a page — that's the surfaces skill.

Triggers from the description

Missing or invalid management key
Original author description

Connect Claude Code to Surface AI, or fix the connection. Use when the user has just installed the Surface AI plugin, when the surface MCP server's tools are missing, or when /mcp shows the surface server failed (for example a 401 or "Missing or invalid management key"). Not for adding a surface to a page — that's the surfaces skill.

How it works

  1. Check the connection
  2. The tools are missing, or /mcp shows surface failed
  3. Without the plugin
Original SKILL.md headings · 38 lines, 261 words
SKILL.md preview
---
name: connect
description: Connect Claude Code to Surface AI, or fix the connection. Use when the user has just installed the Surface AI plugin, when the surface MCP server's tools are missing, or when /mcp shows the surface server failed (for example a 401 or "Missing or invalid management key"). Not for adding a surface to a page — that's the surfaces skill.
---

# Connecting to Surface AI

The plugin connects to Surface's MCP server with a **management key** that the user enters when
they enable the plugin. Claude Code stores it securely; never ask the user to paste the key into
the chat, and never write it to a file.

## Check the connection

If the `surface` tools are available, call `surface_list`. Any result — even an empty list — means
the connection works. Tell the user how many surfaces they have and suggest setting one up on a
page of this codebase.

## The tools are missing, or `/mcp` shows `surface` failed

The key is missing, mistyped or revoked. Claude Code doesn't load the tools until the key works, so
walk the user through:

1. **Get a key.** Open https://app.surface-ai.io/settings/developers and click **Create key**. It
   starts with `mak_live_` and is shown once — copy it then.
2. **Enter it.** Run `/plugin`, choose **surface-ai**, and configure it with the new key.
3. Run `/mcp` to confirm `surface` is connected, then check the connection as above.

For anything else, point the user to https://docs.surface-ai.io/mcp/troubleshooting.

A key belongs to a user, not an organization: revoking one person's key leaves everyone else
connected. If the user revoked a key under Settings → Developers, that key stops working right away.

## Without the plugin

Anyone can connect without the plugin, with the key in the `SURFACE_MANAGEMENT_KEY` environment
variable. Keep the single quotes: they store the variable rather than the key itself.

```bash
claude mcp add --scope user --transport http surface https://mcp.surface-ai.io/mcp/ \
  --header 'Authorization: Bearer ${SURFACE_MANAGEMENT_KEY}'
```

Versions

RepositoryScoreLicence
This page · surface-ai-code/claude-plugins100MIT
redpanda-data/skills100Apache-2.0
ciro-maciel/ccm-stack100MIT
karloscodes/fusionaly-oss100MIT
flung-official/flung-claude-plugin100MIT
nimbalyst/nimbalyst90MIT
ARCASSystems/FounderOS90MIT
suboss87/FDEOps90MIT
nocodework/growth-os90MIT

Database snapshot: 13.11.2026 · package version 3bd63e32196d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90connect-tools
    Use when the owner asks to connect an MCP server, add a plugin, or teach you a new skill.
  • 100mcp-server-builder
    Use to build, wire up, or debug an MCP (Model Context Protocol) server that gives Claude access to an internal API, database, or SaaS tool. Trigger when the user wants Claude to connect to their own system, asks for an MCP server, needs custom tools for Claude Code or the Claude…
  • 100setup-connect
    Step 4 of 4 of the Minecraft Java MCP setup. Register the running minecraft-java MCP server (the Fabric mod) with Claude (Claude Code or Claude Desktop) so the Java world tools become available, then verify the connection with a live test call. Use when the user has the MCP…
  • 100formio-mcp-setup
    Connects the Form.io MCP server (`@formio/mcp`) to whatever coding agent is running, so the Form.io skills have tools to call. Use when a Form.io skill's preflight finds the MCP tools missing, when Form.io tool calls fail because no Form.io tools are available, or when the user…
  • 100uc-mcp-proxy
    Connect Claude Desktop or Claude Code to a Databricks MCP server using uc-mcp-proxy. Use this when setting up, configuring, or troubleshooting a Databricks MCP connection — including Managed MCP, External MCP, and App-hosted MCP servers. Covers auth, .mcp.json config, URL…
  • 100bb-install-and-connect
    Use when bb is installed but the agent has no bb tools, or when wiring bb into Claude Code, Cursor, VS Code, Codex, Gemini, opencode or another agent host.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.