← All guides
MCP CONNECTION GUIDE

Find talent
with Claude Code.

Use Shapers to find people through their work while you draft a role or research a technical field.

01

Get your API key

Sign in to Shapers and open Account → API keys. Make your key available as SHAPERS_API_KEY in the environment that launches your client. Keep the actual key out of chat, shared configuration, and source control.

Open your account ↗
02

Connect the server

Add this server entry to your project’s .mcp.json. Merge it with existing servers if the file already exists.

{
  "mcpServers": {
    "shapers": {
      "type": "http",
      "url": "https://mcp.dev-match.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${SHAPERS_API_KEY}"
      }
    }
  }
}

The MCP endpoint still uses the dev-match.xyz domain. Restart your client after configuring the server and environment variable.

Official client setup reference ↗
03

Verify the connection

Open /mcp in your client and check that Shapers connects and lists find_candidates, get_profile, and find_similar_projects. A missing environment variable or rejected key needs fixing before searching.

A shortlist search uses company credits. Check your plan and balance before running it.

View credits and plans ↗
04

Run a useful search

Find people for this role: [paste the job description]. Separate must-haves from preferences. For each person, show the relevant work, their contribution, source links, and requirements that remain unverified. Finish with a shortlist and specific follow-up questions.

Ask your assistant to use Shapers find_candidates with your brief as input. Inspect the source links before deciding who belongs on the shortlist. Client connection and tool visibility alone do not verify result quality.

Continue to the shortlist workflow ↗