Back to MCP Hub
ChatGPT Integration

Connect Precept to ChatGPT

Configure ChatGPT Custom Connectors to query target account insights, B2B contact data, and company enrichment natively during your conversations.

Start Free Trial
Custom Connector Setup

ChatGPT Custom Connector (OAuth 2.1)

Set up Precept as a Custom Connector in your ChatGPT settings interface. This leverages our secure, deployed OAuth 2.1 flow to authenticate ChatGPT to query Precept's B2B tools.

1

Sign Up & Get Your Precept API Key

Before setting up the custom connector in ChatGPT, make sure you have your Precept API key ready:

  1. Sign up for an account or log in at app.preceptai.co.uk.
  2. Navigate to the Developer Dashboard.
  3. Click Generate New API Key (or copy your existing key).

Copy your API key (starts with pt_ or precept_sk_...). You will paste it in Step 8 to authorize ChatGPT.

2

Open ChatGPT Settings

Log in to your ChatGPT account. Click on your profile icon in the bottom-left corner of the sidebar, and select Settings from the popup menu.

3

Access Apps Settings

In the Settings modal, select the Apps tab from the left sidebar. Locate the Advanced settings row under Developer features, and click the Create app button.

4

Enable Developer Mode

Ensure the Developer mode toggle is switched to ON. This enables ChatGPT to connect to custom MCP servers that you run locally or host in the cloud.

5

Create a New App

Enter a Name for your connector (e.g. PreceptAI). Under Connection, select Server URL. For Authentication, select OAuth and click to expand the Advanced OAuth settings panel.

6

Configure Connection & OAuth

Fill out the form details using our hosted endpoint:

  • Connection URL: https://precept-mcp-server-production.up.railway.app/mcp
  • Registration method: User-Defined OAuth Client
  • Client ID: chatgpt
  • Token Auth method: none

Check the custom MCP server risk confirmation checkbox and click Create.

7

Add App to ChatGPT

When the confirmation popup appears, select the PreceptAI app to start integration. Click the Sign in with PreceptAI button on the prompt to open the authorization window.

8

Authorize Connector with API Key

Paste your secure Precept API Key (copied in Step 1) and click the Authorize Connector button to approve the integration.

9

Verify Active Connection

Navigate back to your ChatGPT Settings -> Apps. You should see PreceptAI successfully connected under active apps list along with its server URL.

10

Query Precept AI via Chat

Ask ChatGPT a natural language prompt (e.g., "Find sales managers in London using Precept"). ChatGPT will automatically trigger the Precept MCP tools, track the background job progress, poll the status tool, and format the results as a neat markdown table in your conversation.

Example Usage in ChatGPT

Once connected, ChatGPT can natively use Precept to retrieve sales leads, find companies, and generate B2B intelligence tables in real-time.

Maintenance & Sync

How to Reconnect & Sync Precept Tools

ChatGPT caches tool definitions and schemas. When new Precept features or parameter updates are deployed, follow these steps to re-sync your connected tools:

  1. Open Settings in ChatGPT and click the Plugins tab.
  2. Select PreceptAI from your list of connected apps.
  3. Click the three dots (...) in the top-right corner.
  4. Click Reconnect (or refresh in plugin details/information) to sync the latest tool definitions.
đź’ˇ Tip: Reconnecting forces ChatGPT to fetch the latest tool schemas immediately, clearing any validation errors from previous sessions.

Available Tools

The Precept MCP server gives ChatGPT 13 tools. Each one is labelled Read-only (only looks things up), Uses credits (spends Precept credits but changes nothing else), or Takes action (creates, changes or deletes something in your account, or acts on LinkedIn for you). Credit costs are starting prices. Options like phone numbers cost more; see pricing for full rates.

Lead discovery

precept_search_leadsUses credits

Finds people who match a description of your ideal customer, such as job title, industry, company size and location. Can also add AI insights, verified emails and phone numbers, or a filter for people who recently engaged with posts on a topic.

Credits: From 0.1 per lead

precept_get_leads_from_post_searchUses credits

Finds people who recently wrote LinkedIn posts on given keywords, in the past 24 hours, week or month. Each result includes the post they wrote.

Credits: From 5.1 per lead

precept_enrich_leadsUses credits

Adds detail to contacts you already have, identified by LinkedIn URL or name and company: verified email and phone, professional summary, likely problems and initiatives. Can also draft a personalised email or LinkedIn message.

Credits: From 1 per lead

Company intelligence

precept_search_companiesUses credits

Finds companies from a plain-language description, for example “SaaS companies in London with 50–200 employees”. Can add decision makers, tech stack, revenue, funding, headcount by department, and answers to your own questions about each company.

Credits: From 1 per company

precept_get_company_insightsUses credits

Returns the same insights for companies you name by website or LinkedIn URL.

Credits: From 1 per company

Monitoring

precept_job_posting_subscriptionsTakes action

Creates, views, updates, lists and deletes recurring checks (every 7–30 days) for new job postings at chosen companies or matching a description, and finds decision makers at the hiring companies.

Credits: 0.5 per new decision maker found

precept_lead_subscriptionsTakes action

Creates, views, updates, lists and deletes recurring checks on specific people, by LinkedIn URL, for job changes, title changes and new posts. Up to 150 people per organisation.

Credits: See pricing

LinkedIn outreach (requires the Precept Chrome extension)

precept_campaign_queueTakes action

Queues LinkedIn connection campaigns to a list of leads, and shows, pauses, resumes, archives or removes them. Campaigns run one at a time, through the Precept extension in your own Chrome browser.

Credits: See pricing

precept_linkedin_messagesTakes action

Sends one LinkedIn message (or a connection note if you aren't connected yet) to one person from your LinkedIn account, and checks whether it was delivered.

Credits: See pricing

precept_get_extension_statusRead-only

Checks whether the Precept Chrome extension is installed and active, and which version is running.

Credits: None

Account and jobs

precept_check_creditsRead-only

Shows your remaining Precept credit balance.

Credits: None

precept_get_job_statusRead-only

Searches and enrichments run in the background. This checks a job's progress and returns its results when it finishes.

Credits: None

precept_check_versionRead-only

Checks whether your connection is using the latest version of the Precept server.

Credits: None

Data & Permissions

What ChatGPT can see and do once Precept is connected, what Precept receives, and how to disconnect.

What ChatGPT can access

  • ChatGPT acts as the Precept account whose API key you used to connect. With an organisation key, it uses that organisation’s credits and data.
  • It can read your credit balance, search and enrichment results, subscriptions, campaign queue and message delivery status.
  • Lead and company results come from Precept’s database of business profiles and public company information. They don’t come from your private LinkedIn data.

What ChatGPT can do for you

  • Spend Precept credits on searches and enrichments.
  • Create, change and delete job-posting and lead subscriptions.
  • Save lead lists to your Precept dashboard, and queue, pause or archive LinkedIn campaigns.
  • Send LinkedIn messages and connection requests from your LinkedIn account. This only works if you’ve installed the Precept Chrome extension and are signed in to LinkedIn in Chrome.
  • Send results to a webhook URL, but only if you give one.

What Precept receives

  • Only what ChatGPT puts in each tool call, such as search descriptions, LinkedIn URLs, company websites and message text.
  • Precept doesn’t receive your conversation history, files, or data from your other tools.
  • Precept stores searches, results, subscriptions and campaigns in your Precept account, as described in our privacy policy.

How sign-in works

  • The connection uses OAuth 2.1 with PKCE. You paste your Precept API key into Precept’s own authorisation page, never into a chat.
  • The key is encrypted (AES-256) before it’s stored. The one-time authorisation code expires after 5 minutes.
  • The app receives an access token that lasts 1 hour and a refresh token that lasts 90 days. It never sees your raw API key.

Staying in control

Review what ChatGPT plans to do before you confirm, especially for the Takes action tools (messaging, campaigns and subscriptions), which change your account or act on LinkedIn. Check your balance at any time with precept_check_credits.

Disconnecting

  1. In ChatGPT, open Settings → Apps, select PreceptAI and disconnect or delete it.
  2. To cancel all existing access straight away, regenerate your API key on the Precept developer page. Anything using the old key stops working.
  3. To stop all LinkedIn activity, remove the Precept Chrome extension or archive your campaigns.