{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-mcp/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Setup Instructions","description":"Checkr developer documentation for background check APIs, embeds, and partner integrations."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"setup-instructions","__idx":0},"children":["Setup Instructions"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-your-credentials","__idx":1},"children":["Get Your Credentials"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a Checkr account (or use an existing one) in the target environment (Production or Staging)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account → Developer Settings"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate MCP Credentials"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Endpoint"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are unique to your Checkr account. Keep them secure — you'll need all three in the next step. The Client Secret is shown only once; copy it immediately."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authenticate-your-client","__idx":2},"children":["Authenticate Your Client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Establish a secure connection by fetching an OAuth access token. This allows your system to communicate with Checkr's APIs securely."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flow"]},": Client Credentials"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action"]},": Exchange your Client ID and Client Secret for a bearer access token at the Token Endpoint provided during credential provisioning."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security"]},": Store credentials in protected environment variables — never hard-code them."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST <token_endpoint>\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=client_credentials&client_id=<ID>&client_secret=<SECRET>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-to-the-mcp-server","__idx":3},"children":["Connect to the MCP Server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Point your MCP client at the Checkr server using the token from the previous step."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.checkr.com/candidate/"]}," (Production) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.checkr-staging.com/candidate/"]}," (Staging)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]}," on every request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transport"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Streamable HTTP (session-stateful — each connection maintains identity state)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once connected, the MCP protocol handles the rest — your LLM automatically discovers the available tools, their parameters, and descriptions directly from the server. No manual tool configuration is needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"session-persistence","__idx":4},"children":["Session persistence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the initial connection, the server returns an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Mcp-Session-Id"]}," header. This header ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["must"]}," be included on all subsequent requests within the same session — without it, each request creates a new session and any candidate binding is lost. If you're using an agent framework with built-in MCP support (e.g., Claude, OpenAI Agents SDK, LangChain), session persistence is handled automatically. If your agent uses a custom HTTP client to connect to the MCP, ensure it preserves and forwards this header across requests."]}]},"headings":[{"value":"Setup Instructions","id":"setup-instructions","depth":1},{"value":"Get Your Credentials","id":"get-your-credentials","depth":2},{"value":"Authenticate Your Client","id":"authenticate-your-client","depth":2},{"value":"Connect to the MCP Server","id":"connect-to-the-mcp-server","depth":2},{"value":"Session persistence","id":"session-persistence","depth":3}],"frontmatter":{"title":"Setup Instructions","description":"Provision your Candidate MCP credentials, exchange them for a bearer token, and connect your agent over Streamable HTTP.","seo":{"title":"Setup Instructions"}},"lastModified":"2026-10-26T11:44:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp/candidate/setup-instructions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}