> ## 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 ChatGPT

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

<Warning>
  **ChatGPT users — read first.** The way ChatGPT currently connects to MCP servers requires a quick manual setup on our side before authentication will go through. Go ahead and configure the connector as normal, but expect the sign-in step to fail on first attempt — this is normal. Once the connector is added, [contact our customer support team](mailto:support@spott.io) so we can enable and finalize your connection. You'll be able to authenticate successfully once we confirm, usually within one business day. Other clients like Claude and Cursor work out of the box.
</Warning>

The Spott connector for ChatGPT lets recruiters work in Spott directly from a ChatGPT conversation. ChatGPT 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 ChatGPT. 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 ChatGPT account on any plan (Free, Go, Plus, Pro, Business, Enterprise, or Education)

## Connect Spott to ChatGPT

<Note>
  Creating a custom MCP connection is currently only supported in the web version of ChatGPT and is not available in the desktop or mobile apps.
</Note>

<Step title="Enable Developer Mode" stepNumber={1}>
  In ChatGPT, click your profile icon in the bottom-left corner and open **Settings**. From there, navigate to **Apps → Advanced settings** and enable **Developer mode**.

  <Frame>
    <img src="https://mintcdn.com/spott/XIuDPjjKVfF3RBE3/images/chatgpt_mcp_dev_mode.png?fit=max&auto=format&n=XIuDPjjKVfF3RBE3&q=85&s=e4a414eb637040133c884f5d18a7f294" alt="chatgpt_mcp_dev_mode" width="735" height="654" data-path="images/chatgpt_mcp_dev_mode.png" />
  </Frame>
</Step>

<Step title="Create a New App" stepNumber={2}>
  Once Developer mode is enabled, go to **Settings → Apps** and click **Create app**. You can choose any name for the app, but we recommend using *Spott MCP* for clarity. In the **MCP Server URL** field, enter `https://mcp.spott.io/mcp`, and set the **Authentication** method to **OAuth**. After reviewing the configuration, confirm by selecting the “I understand and want to continue” checkbox, then click **Create** to finish setting up the app.

  <Frame>
    <img src="https://mintcdn.com/spott/XIuDPjjKVfF3RBE3/images/chatgpt_mcp_setup.png?fit=max&auto=format&n=XIuDPjjKVfF3RBE3&q=85&s=88ad2888bf673d72694eb50338153ebf" alt="chatgpt_mcp_setup" width="516" height="836" data-path="images/chatgpt_mcp_setup.png" />
  </Frame>
</Step>

<Step title="Contact Support" stepNumber={3}>
  At this point, the app will be created successfully, but it will not function yet. [**Contact the Spott support team**](mailto:support@spott.io) to enable and finalize the MCP connection for your account.
</Step>

<Step title="Connect the App" stepNumber={4}>
  Once you have received confirmation that your account has been set up, go back to **Settings** → **Apps** → **Spott** and click **Connect**.

  <Frame>
    <img src="https://mintcdn.com/spott/XIuDPjjKVfF3RBE3/images/chatgpt_mcp_connect.png?fit=max&auto=format&n=XIuDPjjKVfF3RBE3&q=85&s=a3e855d74f9d95949ec70b8024c90968" alt="chatgpt_mcp_connect" width="777" height="677" data-path="images/chatgpt_mcp_connect.png" />
  </Frame>

  This will bring you to an authentication screen where you need to grant access. If this page does not load correctly, clear the cookies on `app.spott.io` and try again.

  <Frame>
    <img src="https://mintcdn.com/spott/XIuDPjjKVfF3RBE3/images/chatgpt_mcp_auth.png?fit=max&auto=format&n=XIuDPjjKVfF3RBE3&q=85&s=fc74bc8e327c63b5a4818481b269911e" alt="chatgpt_mcp_auth" width="396" height="663" data-path="images/chatgpt_mcp_auth.png" />
  </Frame>
</Step>

<Step title="Enable for your conversation" stepNumber={5}>
  Click `+` → **More** → **Spott MCP** in your chat to enable the Spott connector for this conversation.

  <Frame>
    <img src="https://mintcdn.com/spott/XIuDPjjKVfF3RBE3/images/chatgpt_mcp_enable.png?fit=max&auto=format&n=XIuDPjjKVfF3RBE3&q=85&s=1980a6c5b39ade3ee9d6dc206137c2fc" alt="chatgpt_mcp_enable" width="861" height="543" data-path="images/chatgpt_mcp_enable.png" />
  </Frame>
</Step>

## 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. ChatGPT can only see and modify records you have access to in the Spott UI.

* **Tenant isolation:** Each user authenticates with their own Spott credentials. ChatGPT 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 ChatGPT treats them with extra care.
* **Confirmation for high-impact actions:** ChatGPT 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 ChatGPT → **Settings** → **Apps**. 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="ChatGPT doesn't use Spott when I expect it to">
    Make sure the Spott connector is enabled for the current conversation (`+` → **More**).
  </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, ChatGPT 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 ChatGPT-specific connector questions, see [OpenAI's connectors help](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt).