FlawPilot
MCP

Connect your AI assistant to FlawPilot

FlawPilot ships an MCP server so the AI tools you already use - Claude, Cursor, ChatGPT, and any MCP-compatible client - can trigger a scan and read the findings back, right inside your editor or chat. This guide walks through connecting one in a couple of minutes.

Remote MCP server URL
https://mcp.flawpilot.com/mcp

You'll need a FlawPilot account and an MCP-capable client. The server is remote - nothing to install locally. With OAuth, there's no key to copy at all.

MCP connected
Your AI assistant
MCP
FlawPilot
You
Scan example.com with FlawPilot and summarize the critical findings.
Assistant · via FlawPilot
Overall 82. 1 critical: API key exposed in JS bundle. 2 high on headers. Want the fixes?

What is MCP, and why connect it?

The Model Context Protocol (MCP) is an open standard that lets AI assistants talk to external tools. Connecting FlawPilot turns your assistant into a security co-pilot.

Trigger scans from chat

Ask your assistant to scan a URL and it starts a FlawPilot scan for you - no context switch, no dashboard, no copy-pasting links.

Read findings inline

Scores and prioritized findings come straight back into the conversation, so your assistant can explain and act on them where you're already working.

Turn findings into fixes

Because the findings live in the same context as your code, your assistant can draft the header, config, or DNS change that resolves each issue.

Before you start

  • A FlawPilot account - create one free from the dashboard.
  • An MCP-compatible client: Claude (desktop or Code), Cursor, VS Code Copilot, Antigravity, or any tool that speaks MCP.
  • For OAuth-capable clients, nothing else - the connect flow handles auth. For the REST API, CI, or clients without OAuth, a FlawPilot API key from Settings - API keys (the same key works for both).

Two ways to connect

Pick one path. OAuth is the recommended, no-key way if your client supports it. Otherwise use an API key - the same key also works for the REST API and CI.

A

Connect with OAuth

Recommended

Nothing to copy. Works with any MCP client that has an "Add connector" / "Connect" flow (Claude Code, Claude.ai, Claude Desktop, and more).

1

Point your client at FlawPilot

In Claude Code, run the claude mcp add command from the config below WITHOUT a header. In Claude.ai or Claude Desktop, open Settings - Connectors - Add custom connector and paste the MCP server URL (it's in the reference below). No key to create or copy.

claude_desktop_config.json
{
  "mcpServers": {
    "flawpilot": {
      "url": "https://mcp.flawpilot.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
2

Approve in your browser

Your browser opens the FlawPilot login, shows which app is asking, and lets you pick a workspace if you belong to more than one. Click Approve and the client is connected - the FlawPilot tools appear in your assistant. (It creates an ordinary API key you can revoke later from Settings - API keys.)

FPAuthorize connection

Claude Desktop wants to connect to your FlawPilot workspace.

Workspace
Acme Inc.
CancelApprove
3

Scan from your assistant

Ask something like "Scan example.com with FlawPilot and summarize the critical findings." It triggers the scan, waits for results, and reports the scores and prioritized fixes back into the conversation.

You
Scan example.com with FlawPilot and summarize the critical findings.
calling trigger_scan
Assistant
Overall 82. 1 critical: API key exposed in JS bundle. 2 high on headers. Want the fixes?
B

Use an API key

Alternative

For the REST API, CI/scripts, or an MCP client that doesn't support OAuth yet. Creating keys requires the Owner or Admin role.

1

Generate an API key

Sign in, open Settings - API keys, and click Generate key. Give it a name you'll recognise later - for example "Claude Desktop" or "CI pipeline". The same key works for MCP and the REST API.

Generate API key

Give the key a name so you can recognise it later.

CI pipeline
CancelGenerate
2

Copy it and store it safely

FlawPilot shows the key once, in the "Copy your API key" dialog - click Copy and paste it somewhere secure straight away, because you won't be able to see it again. FlawPilot only stores a hash, never the raw key. Revoke a key from the list any time.

Copy your API key

This is the only time you'll see this key. Copy it now and store it securely.

81939a424b72ae405429f97ffffd8f250a2277928948Copy
Done
3

Add the server to your client

Add a new remote server in your client's connector or MCP settings pointing at the FlawPilot MCP endpoint over the Streamable HTTP transport, and paste your key as its Bearer credential (see the per-client config below). Nothing to install - it's a remote server.

claude_desktop_config.json
{
  "mcpServers": {
    "flawpilot": {
      "url": "https://mcp.flawpilot.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
4

Scan from your assistant

Ask something like "Scan example.com with FlawPilot and summarize the critical findings." It triggers the scan and reports the scores and prioritized fixes back into the conversation.

You
Scan example.com with FlawPilot and summarize the critical findings.
calling trigger_scan
Assistant
Overall 82. 1 critical: API key exposed in JS bundle. 2 high on headers. Want the fixes?

The FlawPilot MCP server

Every client below connects to the same remote MCP endpoint over the Streamable HTTP transport. OAuth-capable clients authenticate through the connect flow (no key to paste); manual setups send an API key as a Bearer token in the Authorization header - the same key works for the REST API too. Replace YOUR_API_KEY in every snippet with your own key.

Remote MCP server URL
https://mcp.flawpilot.com/mcp

The MCP endpoint is rolling out. Until it is live for your account, the config below is the exact shape it will take - the URL and key are all that change.

Client-specific setup

The endpoint and key are the same everywhere - only where you paste them changes. Swap YOUR_API_KEY for the key from your dashboard.

AI tools & editors

Desktop apps and IDEs with a connector or MCP settings panel.

Claude Desktop

OAuth (recommended): open Settings - Connectors - Add custom connector and paste the MCP server URL; approve in your browser, no key needed. To use a key instead, open Settings - Developer - Edit Config and add the block below to claude_desktop_config.json.

claude_desktop_config.json
{
  "mcpServers": {
    "flawpilot": {
      "url": "https://mcp.flawpilot.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Command line

Terminal-based clients you configure with a command.

Claude Code

Claude Code detects OAuth support: run the command WITHOUT a header and it opens your browser to approve - nothing to copy. If you'd rather paste a key, add the --header form instead.

Terminal - OAuth (recommended)
claude mcp add flawpilot --transport http https://mcp.flawpilot.com/mcp
Terminal - with an API key
claude mcp add flawpilot --transport http https://mcp.flawpilot.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

What your assistant can do once connected

The FlawPilot MCP server exposes these tools to your AI assistant.

list_projects

Lists your workspace's projects with their project ID, name, and status - so your assistant can pick which project a scan belongs to.

trigger_scan

Queues a scan for a URL against one of your projects. Always confirms the project, pillars, and report email first - it won't assume defaults on your behalf.

get_scan_status

Checks a scan's progress and, once complete, returns its scores - so your assistant can report back when it's done.

Frequently asked questions

OAuth is just an easier way to get a key into your client - your browser opens the FlawPilot login, you approve, and the client is connected with no key to copy. It still creates an ordinary API key behind the scenes (named after the client), which shows up in Settings - API keys and can be revoked there. A manual key is the same kind of credential, you just create and paste it yourself. Both authenticate the same way; neither expires on its own.

Ready when you are

Bring FlawPilot into your AI workflow

Generate a key, connect your assistant, and start scanning from the tools you already use every day.

Open your dashboard