Connect AI tools with MCP

Connect the Surfaced MCP server to this AI tool and confirm it works.

## Server
- Name: surfaced
- URL: https://getsurfaced.in/api/mcp
- Transport: Streamable HTTP (a remote server; nothing to install or run locally)
- Auth: send the header `Authorization: Bearer <API key>`
- API key: ask me for it before you start (it starts with sfc_; I create it in Surfaced under Settings → API and MCP). Never make one up. Use it wherever SURFACED_API_KEY appears below.

## Steps
1. Work out which tool you are running in, then follow only the matching instructions:

Claude Code: run this in the terminal (add `--scope user` before `surfaced` to make it available in every project):
```
claude mcp add --transport http surfaced https://getsurfaced.in/api/mcp --header "Authorization: Bearer SURFACED_API_KEY"
```
Then check it with `claude mcp list`. If the tools are not available in this session yet, tell me to run /mcp or restart Claude Code.

Cursor: add this server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project). Merge it into the existing "mcpServers" object; do not remove other servers.
```json
{ "mcpServers": { "surfaced": { "url": "https://getsurfaced.in/api/mcp", "headers": { "Authorization": "Bearer SURFACED_API_KEY" } } } }
```
Then tell me to enable "surfaced" under Cursor Settings → MCP if it is not on already.

VS Code (GitHub Copilot agent mode): add this to .vscode/mcp.json, merging with anything already there. The key is asked for once and stored by VS Code, not written to the file.
```json
{
  "inputs": [{ "type": "promptString", "id": "surfaced-key", "description": "Surfaced API key", "password": true }],
  "servers": { "surfaced": { "type": "http", "url": "https://getsurfaced.in/api/mcp", "headers": { "Authorization": "Bearer ${input:surfaced-key}" } } }
}
```
Then tell me to click Start above the server in mcp.json and paste the key when asked.

Claude Desktop: it connects to remote servers with header auth through the mcp-remote bridge, which needs Node.js. Add this to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), merging into "mcpServers":
```json
{ "mcpServers": { "surfaced": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://getsurfaced.in/api/mcp", "--header", "Authorization:Bearer ${SURFACED_KEY}"],
  "env": { "SURFACED_KEY": "SURFACED_API_KEY" }
} } }
```
If you cannot edit files yourself, give me the merged file and the exact path, then tell me to fully quit and reopen Claude Desktop.

Windsurf: add this to ~/.codeium/windsurf/mcp_config.json, merging into "mcpServers":
```json
{ "mcpServers": { "surfaced": { "serverUrl": "https://getsurfaced.in/api/mcp", "headers": { "Authorization": "Bearer SURFACED_API_KEY" } } } }
```
Then tell me to press Refresh in Windsurf's MCP panel.

If you are a different MCP client, add a remote Streamable HTTP server with the URL and Authorization header above, following your own documentation.

2. Keep the key out of git. Prefer user-level config; if you write it into a project file, make sure that file is gitignored or use the tool's own secret prompt.
3. Load the server, then list its tools. You should see: check_page, generate_llms_txt, list_sites, get_report, run_audit, get_audit, get_credits.
4. Call get_credits and tell me my balance and what a report costs.
5. Find this project's main page (for example app/page.tsx, pages/index.tsx, src/routes/+page.svelte or index.html). Get its HTML, rendered if you can, and call check_page with it (pass page_url if you know the live URL). Summarise the top fixes in plain language, then ask me before changing any files.

## Rules
- Do not call run_audit during setup; it uses credits. check_page and generate_llms_txt are free.
- If you get 401 Unauthorized, the key is wrong or revoked: stop and ask me for a new one.
- If the tools do not show up, show me the exact config you wrote, where you wrote it, and any error from the MCP log. Do not guess at fixes more than once.