MCP Quick Start (Claude Desktop)

Configure Claude Desktop to search jobs via natural conversation in under 3 minutes

Overview

f2d supports the Model Context Protocol (MCP), allowing AI assistants like Claude Desktop to search for jobs through natural conversation. Ask "find me ML engineer jobs in Seattle" and Claude will call f2d's search tools automatically.

Prerequisites

Claude Desktop installed
A web browser (for first-time authentication)

Step 1: Add the Configuration

Open your Claude Desktop MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "f2d": {
      "url": "<your-mcp-endpoint-url>"
    }
  }
}

Replace <your-mcp-endpoint-url> with the MCP endpoint URL provided to you.

You only need the url field. No API key or additional headers required.

Step 2: Restart Claude Desktop

Fully quit Claude Desktop (not just minimize), then reopen it.

On first connection, your browser will open a login page. Register or sign in with your email — it's free. After authentication, Claude Desktop will connect to f2d automatically.

Subsequent connections authenticate silently. You won't need to log in again unless your session expires.

Step 3: Start Searching

In your Claude Desktop conversation, try:

"Find me machine learning engineer jobs in Seattle, show me the top 3"

Claude will automatically call the search_jobs tool and present formatted results.

More Things You Can Ask

"What cities have job listings available?"
"Show me data scientist positions posted in the last week"
"Find product manager jobs in New York with full descriptions"
"List all available cities in the US"

f2d exposes two tools (search_jobs and list_cities). See the MCP Overview for details.

Troubleshooting

Issue	Solution
f2d not showing as connected	Check that the JSON config is valid and the file path is correct. Restart Claude Desktop fully (quit, not minimize).
Browser login page doesn't appear	Verify the MCP endpoint URL is correct. Check your network connection.
Authentication fails	Try again in a few seconds. If persistent, check Claude Desktop logs: `~/Library/Logs/Claude/mcp*.log` (macOS)
First search is slow (5-10 seconds)	This is normal on first request. Subsequent searches are faster.
"Not Acceptable" error in logs	This is typically handled automatically by Claude Desktop. If it persists, update to the latest version.

Next Steps

Learn more about MCP and how it works
See the Claude Desktop setup guide for detailed verification steps
For manual testing or custom integrations, see JSON-RPC Examples

MCP Quick Start (Claude Desktop)

On this page