ChatGPT MCP Integration

Connect your Heyo account to ChatGPT to give it direct access to your conversations, projects, and team data. This enables ChatGPT to help you analyze customer interactions, draft responses, and provide business insights.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like ChatGPT to securely connect to external data sources. When you connect Heyo to ChatGPT, it can:

• Read your projects and team members
• Access conversations and messages
• Search and filter your data
• View saved bookmarks

Prerequisites

• A Heyo Pro account (MCP is a premium feature)
• A ChatGPT Plus, Team, or Enterprise subscription (MCP requires a paid plan)

Setup Instructions

Step 1: Open ChatGPT Settings

1. Go to chatgpt.com
2. Click on your profile picture in the bottom-left corner
3. Select Settings from the menu
4. Click on Apps in the left sidebar

Step 2: Enable Developer Mode

1. Click on Advanced settings
2. Toggle on Developer mode

This allows you to add custom MCP connectors like Heyo.

Step 3: Create Heyo App

1. Click Create app
2. Fill in the details:
   • Name: Heyo
   • Description: (optional) Your Heyo livechat integration
   • MCP Server URL: https://heyo.so/api/mcp
   • Authentication: OAuth
3. Check the box to acknowledge the risks
4. Click Create

Step 4: Authorize Access

After creating the app, you'll be redirected to Heyo to authorize access.

1. If you're not logged into Heyo, you'll be prompted to log in first
2. Review the permissions that ChatGPT is requesting
3. Click Authorize to grant access

Step 5: Verify Connection

Once authorized, you'll be redirected back to ChatGPT. The Heyo app should now appear in your Apps list showing the connection details.

Using Heyo with ChatGPT

Once connected, you can ask ChatGPT questions about your Heyo data. When ChatGPT needs to access Heyo, it will show a permission card asking you to approve the action.

Click the action button (e.g., List Projects) to allow ChatGPT to fetch your data. You can also click Deny if you don't want to proceed.

Example Prompts

Analyze recent conversations:

What were the main topics discussed in my Heyo conversations this week?

Find specific interactions:

Show me conversations where customers had complaints or issues

Team analytics:

Generate a report of team member response times

Customer sentiment:

Analyze the overall sentiment of recent customer conversations

Available Tools

When connected, ChatGPT has access to these Heyo tools:

Troubleshooting

Connection Failed

If the connection fails:

1. Make sure you're logged into your Heyo account in another browser tab
2. Check that your Heyo subscription is active
3. Ensure your ChatGPT subscription supports MCP apps
4. Try removing and recreating the app

Authorization Error

If you see an authorization error:

1. Clear your browser cookies for heyo.so
2. Log out and log back into Heyo
3. Try creating the app again

"Tool not available" Error

If ChatGPT says the Heyo tool isn't available:

1. Check that the app shows as connected in Settings → Apps
2. Start a new chat (apps may not apply to existing conversations)
3. Explicitly mention you want to use Heyo (e.g., "Use Heyo to show me...")

Data Not Loading

If ChatGPT can't fetch your data:

1. Verify the app is still connected in Settings → Apps
2. Make sure your Heyo account has data (projects and conversations)
3. Try creating a new chat and asking again

Security

• All connections use OAuth 2.1 with PKCE for secure authentication
• Access tokens expire after 24 hours and are automatically refreshed
• You can revoke access at any time from ChatGPT's Apps settings
• ChatGPT only has read access and cannot modify your data
• Each tool action requires your explicit approval

Disconnecting

To disconnect Heyo from ChatGPT:

1. Go to ChatGPT Settings → Apps
2. Find the Heyo app and click on it
3. Click Disconnect
4. Confirm the disconnection

This will immediately revoke ChatGPT's access to your Heyo data.