> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partfinder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The PartFinder API is served at https://api.partfinder.dev. Authenticate with `Authorization: Bearer $PARTFINDER_API_KEY`; create an account at https://console.partfinder.dev/sign-up and pick pay as you go or a monthly or yearly plan (see https://partfinder.dev/pricing), then create a key. Pay as you go starts with 100 free credits, once per person and per company.
> Install the PartFinder agent skill with `npx skills add https://docs.partfinder.dev` (skill file: https://docs.partfinder.dev/skill.md).
> The OpenAPI document at https://api.partfinder.dev/v1/openapi.json is the source of truth for request and response schemas.
> What each call costs and current plans: https://api.partfinder.dev/llms.txt.

# Connect Claude Code to the PartFinder MCP server

> Add the PartFinder MCP server to Claude Code and sign in from the /mcp command, or use your own API key from PARTFINDER_API_KEY in a .mcp.json file.

Claude Code connects to the PartFinder server and signs you in through your browser. The server itself
is described in [MCP server](https://docs.partfinder.dev/mcp-server.md).

## Add the server and sign in

1. Add the server:

   ```bash theme={null}
   claude mcp add --transport http partfinder https://api.partfinder.dev/mcp
   ```

   To share the server with a project instead, add this entry to `.mcp.json` at the project root:

   ```json theme={null}
   {
     "mcpServers": {
       "partfinder": {
         "type": "http",
         "url": "https://api.partfinder.dev/mcp"
       }
     }
   }
   ```

2. In Claude Code, type `/mcp` and choose `partfinder`.

3. Follow the steps in your browser: sign in to PartFinder, choose your organization and approve the two
   [permissions](https://docs.partfinder.dev/mcp-server.md#the-two-permissions).

If your browser does not open, copy the address Claude Code shows and open it yourself.

## Check the connection

Run `claude mcp get partfinder` to see the server's status, or ask Claude "Is PartFinder connected?".
Claude calls the `ping` tool, which is free.

## Can I use my own API key?

Yes. The `.mcp.json` file can refer to an environment variable, so it holds no key and you can commit it.

1. Set `PARTFINDER_API_KEY` in your environment to your API key.

2. Create `.mcp.json` at the project root, or add the `partfinder` entry to the one you have:

   ```json theme={null}
   {
     "mcpServers": {
       "partfinder": {
         "type": "http",
         "url": "https://api.partfinder.dev/mcp",
         "headers": {
           "Authorization": "Bearer ${PARTFINDER_API_KEY}"
         }
       }
     }
   }
   ```

3. Start `claude` in the project and approve the `partfinder` server when Claude Code asks.

Do not add the server with `claude mcp add --header "Authorization: Bearer $PARTFINDER_API_KEY"`. Your
shell replaces the variable with the key before Claude Code sees it, so the key is stored in the
configuration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.