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

# Use Spott in Claude

> Connect Spott to Claude to run your full recruiting workflow from chat — search candidates, manage pipelines, schedule interviews, send emails, and place candidates without leaving the conversation.

The Spott connector for Claude lets recruiters work in Spott directly from a Claude conversation. Claude can search your candidates, jobs, and companies, move applications through your pipeline, schedule interviews, log calls and notes, send emails, parse CVs, and close placements — all scoped to the authenticated user's tenant and reflected back in the Spott UI in real time.

<Note>
  The connector exposes tools only — there is no separate Spott workspace inside Claude. Every action runs against your live Spott account, and respects the same permissions you have in the Spott UI.
</Note>

## Prerequisites

* An active Spott workspace with a paid subscription
* A Spott user account with the permissions you'd normally use in the Spott UI
* A Claude account on any plan (Free, Pro, Max, Team, or Enterprise)

## Connect Spott to Claude

<Tabs>
  <Tab title="Web / Desktop (Pro/Max)">
    <Steps>
      <Step title="Open the Connectors menu">
        In Claude, go to **Customize** → Select **Connectors** → Click `+` → Select **Add custom connector**
      </Step>

      <Step title="Paste the MCP URL">
        Enter the following URL: **mcp.spott.io/mcp** → Click **Add.**
      </Step>

      <Step title="Authenticate">
        You'll be redirected to a new page. Complete the authentication flow to grant Claude access. You'll then be redirected back to Claude.
      </Step>

      <Step title="Enable for your conversation">
        Click `+` → **Connectors** in your chat and toggle Spott on for this conversation.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web / Desktop (Team/Enterprise)">
    On a Team or Enterprise plan, the owner must first add the connector at the organization level by following these steps:

    <Steps>
      <Step title="(Owner) Open Settings">
        Open Claude → **Settings** → **Connectors**.
      </Step>

      <Step title="(Owner) Add a Custom Connector">
        Click **Add** → Hover over **Custom** → Select **Web.**
      </Step>

      <Step title="(Owner) Paste the MCP URL">
        Enter the following URL: **mcp.spott.io/mcp** → Click **Add.**
      </Step>

      <Step title="Enable for your conversation">
        Click `+` → **Connectors** in your chat and toggle Spott on for this conversation.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Mobile (iOS / Android)">
    <Steps>
      <Step title="Enable on Claude.ai or Claude Desktop">
        The Claude app currently does not support adding custom MCP connectors. However, it does allow you to connect to existing connectors in your account. Please refer to the Web / Desktop steps to enable the connector.
      </Step>

      <Step title="Open the Claude app">
        Tap the `+` icon in the chat bar, then tap **Connectors**.
      </Step>

      <Step title="Connect Spott">
        Find Spott and tap **Connect**. Sign in to Spott when prompted.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What you can do

You can use the Spott connector to:

<CardGroup cols={2}>
  <Card title="Search candidates, jobs & companies">
    *"Find Python engineers in Brussels with 5+ years of experience"*
  </Card>

  <Card title="Manage applications & pipeline">
    *"Move Emma to the offer stage and email her the offer letter"*
  </Card>

  <Card title="Schedule interviews">
    *"Book a 30-minute intro between Mario and Dimitri from Forum Jobs tomorrow at 2pm"*
  </Card>

  <Card title="Log calls, notes & activity">
    *"Log a call with John yesterday — 3 month notice, €85k, available next week"*
  </Card>

  <Card title="Parse CVs & enrich candidates">
    *"Create a candidate from this CV and enrich their email and LinkedIn"*
  </Card>

  <Card title="Place candidates & close deals">
    *"Place Sarah at Google as Senior PM, start date Feb 1, 25% fee"*
  </Card>
</CardGroup>

## Permissions and data scope

The Spott connector respects every permission and role configured in your Spott workspace. Claude can only see and modify records you have access to in the Spott UI.

* **Tenant isolation:** Each user authenticates with their own Spott credentials. Claude never sees data outside your tenant.
* **Read and write:** The connector includes both read tools (search, lookup, activity) and write tools (create, update, send). Write tools with external side effects (sending emails, scheduling interviews, placing candidates) are flagged so Claude treats them with extra care.
* **Confirmation for high-impact actions:** Claude will confirm with you before sending external communications or making irreversible changes like placing a candidate or rejecting an application.

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth fails or times out">
    Disconnect and reconnect Spott from Claude → **Settings** → **Connectors**. Clear cookies for `app.spott.io` if the issue persists. If your workspace uses SSO, make sure your identity provider session is active before connecting.
  </Accordion>

  <Accordion title="Claude doesn't use Spott when I expect it to">
    Make sure the Spott connector is enabled for the current conversation (`+` → **Connectors**). If you have many connectors active, switch tool access mode to **On demand** to give Claude more room to surface Spott reliably.
  </Accordion>

  <Accordion title="A tool returns 'permission denied' or 'not found'">
    The Spott MCP enforces the same permissions as the Spott UI. If you can't see a record in Spott itself, Claude can't either. Ask your workspace admin to grant the required role.
  </Accordion>

  <Accordion title="Interview scheduling fails">
    `spott_schedule_interview` schedules an interview against an existing application. If the candidate doesn't have an application on the relevant job yet, create the application first (for example: *"Add Mario as an applicant on the Forum Jobs Senior Backend role"*) and try again.
  </Accordion>

  <Accordion title="Placement fails or returns an error">
    `spott_place_candidate` advances an existing application to the placed stage. The candidate must already be on a job's pipeline. If they aren't, create the application first.
  </Accordion>
</AccordionGroup>

## Privacy and security

* Spott is hosted in the EU and is GDPR-compliant.
* Customer data is never used to train AI models.
* All data is encrypted in transit (TLS) and at rest.
* A Data Processing Agreement (DPA) is available on request.

For full details, see the [Spott Privacy Policy](https://spott.io/privacy).

## Support

<CardGroup cols={2}>
  <Card title="Email support" icon="envelope" href="mailto:support@spott.io">
    [support@spott.io](mailto:support@spott.io)
  </Card>

  <Card title="Spott documentation" icon="book" href="https://docs.spott.io">
    docs.spott.io
  </Card>
</CardGroup>

For Claude-specific connector questions, see [Anthropic's connectors help](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities).