How to set up Get on Board's MCP server with ChatGPT

When you source candidates from ChatGPT as a recruiter or company team, Get on Board’s MCP server connects ChatGPT to Talent Database so you can search Latin American tech professionals from your ChatGPT conversation.

ChatGPT currently handles custom MCP connections through apps in Developer Mode. OpenAI describes Developer Mode and full MCP app support as beta, so labels and availability may change by plan, region, and workspace settings. Use the steps below for the tested Get on Board setup.

Before you start

You need:

  • A ChatGPT workspace that lets you create custom apps with MCP.
  • Developer Mode enabled in ChatGPT.
  • A Get on Board recruiter account with access to an accepted company.
  • The remote MCP server URL: https://www.getonbrd.com/mcp.

Enable Developer Mode in ChatGPT

In ChatGPT, open Settings → Apps and enable Developer Mode.

Keep Developer Mode active after setup. In current ChatGPT behavior, the custom Get on Board app remains usable for Talent Database queries only while Developer Mode is active.

If you do not see Developer Mode, check your ChatGPT plan and workspace permissions. OpenAI documents Developer Mode and MCP apps as beta features for ChatGPT Business, Enterprise, and Edu workspaces on ChatGPT web, controlled by workspace settings and admin permissions.

Create the Get on Board app

After Developer Mode is active, create a new app in ChatGPT.

Use these values exactly:

  • Name: Get on Board
  • Description: Find tech talent in Latin America
  • MCP Server URL: https://www.getonbrd.com/mcp
  • Authentication: OAuth

Leave the icon optional unless your workspace requires one. Accept the custom MCP server risk notice only if you understand that ChatGPT is connecting to a custom app you are adding to your workspace.

Click Create.

Authorize Get on Board

When ChatGPT opens the authorization flow:

  1. Sign in to Get on Board with your recruiter account.
  2. Select the company context ChatGPT should use.
  3. Approve the requested MCP access.

After authorization, start a new ChatGPT conversation if the Get on Board tools do not appear immediately.

Verify the connection

In ChatGPT, ask:

Use the Get on Board MCP server to call whoami and confirm my active company.

ChatGPT should return your Get on Board identity, the active company context, and the available MCP tools.

Then try a Talent Database search, for example:

Use Get on Board to find senior Python engineers in Mexico with English C1 who are available soon.

What ChatGPT can do with this server

See the Get on Board MCP Server overview for the full tool reference and example workflows.

If you need to reconnect

In ChatGPT, open Settings → Apps, remove the Get on Board app, and create it again with the same values:

  • MCP Server URL: https://www.getonbrd.com/mcp
  • Authentication: OAuth

Then authorize Get on Board again from the browser flow. Keep Developer Mode active before testing a new Talent Database query.

Troubleshooting

Why did the Get on Board tools disappear?

Get on Board’s MCP access tokens last 2 hours, and the server does not issue a refresh token. When your token expires, ChatGPT loses access to the Get on Board tools until you authorize again. Follow “If you need to reconnect” above — expect this to happen periodically during a long session, it is not a bug. If authorizing again does not bring the tools back, wait a few minutes before you retry — several attempts in a row can hit our rate limits.

Run whoami first

Whenever you are not sure the connection is working, ask ChatGPT to call whoami before anything else. It confirms your Get on Board identity, active company, granted scopes, and available tools, and it needs the least access of any tool to run. If whoami is the only tool ChatGPT lists, your current authorization only grants the baseline “Confirm your Get on Board identity” permission — see the Talent Database permission below.

Use the exact server URL

Enter https://www.getonbrd.com/mcp exactly, matching “Before you start” above. A typo in the domain or the path sends your client to a server that is not ours, and the connection fails before OAuth starts.

Candidate search needs the Talent Database permission

The Talent Database search tool appears only when your authorization granted the “Search professionals in Talent Database” permission. The authorization screen lists the permissions your client asked for — you cannot add one there. So if whoami does not list that permission, remove the Get on Board connection in ChatGPT and add it again, so it registers from scratch and asks for the permission.

Related articles