Skip to content

Connecting to the Faraday MCP Server

Instructions for connecting AI clients to an already-running Faraday MCP server.

Prerequisites

  • Server URL: https://fastmcp.apps-dev.faradaysec.com/mcp
  • Faraday instance URL: your Faraday server (e.g. https://your-faraday-instance.com)
  • Credentials: API token, or username + password

Note: The examples below show how to connect to popular MCP clients like Claude Desktop and Claude Code. However, the integration can likely be adapted to work with most MCP-compatible clients.

Claude Desktop

Add the following to your claude_desktop_config.json:

Token auth: 

{
  "mcpServers": {
    "faraday": {
      "type": "http",
      "url": "https://fastmcp.apps-dev.faradaysec.com/mcp",
      "headers": {
        "X-Faraday-URL": "https://your-faraday-instance.com",
        "X-Faraday-Token": "your-api-token"
      }
    }
  }
}

Username/password auth: 

{
  "mcpServers": {
    "faraday": {
      "type": "http",
      "url": "https://fastmcp.apps-dev.faradaysec.com/mcp",
      "headers": {
        "X-Faraday-URL": "https://your-faraday-instance.com",
        "X-Faraday-Username": "your-username",
        "X-Faraday-Password": "your-password"
      }
    }
  }
}

Claude Code

Run one of the following commands to register the server:

Token auth: 

claude mcp add --transport http faraday https://fastmcp.apps-dev.faradaysec.com/mcp \
  --header "X-Faraday-URL: https://your-faraday-instance.com" \
  --header "X-Faraday-Token: your-api-token"

Username/password auth: 

claude mcp add --transport http faraday https://fastmcp.apps-dev.faradaysec.com/mcp \
  --header "X-Faraday-URL: https://your-faraday-instance.com" \
  --header "X-Faraday-Username: your-username" \
  --header "X-Faraday-Password: your-password"

Config file locations: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

After editing the config, fully quit and restart Claude Desktop.

Verification

Once connected, test with:

"List my Faraday workspaces"

Troubleshooting: - No workspaces returned — check that X-Faraday-URL points to a reachable Faraday instance - Authentication errors — verify your token or credentials are correct - Connection refused — confirm the MCP server is running and accessible at the URL