How to connect Heroku to ChatGPT

1. 1. Enable Heroku in Metorial

   In your Metorial portal, enable the Heroku MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

2. 2. Add a custom MCP server

   On ChatGPT web, open Plugins, select +, then Add custom MCP server.

3. 3. Paste your Metorial MCP URL

   Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.

4. 4. Create and install the plugin

   Select Create as a plugin, install it and sign in to load Heroku tools.

• Scale Formation: View or scale dyno formations for a Heroku app.
• Manage Collaborators: List, add, or remove collaborators who have access to a Heroku app.
• List Apps: List all Heroku applications accessible to the authenticated user.
• Get Account: Retrieve the authenticated user's Heroku account details including email, verification status, and two-factor authentication status.
• Update App: Update a Heroku application's settings.
• Create App: Create a new Heroku application.
• Delete App: Permanently delete a Heroku application.
• Manage Add-ons: List, provision, update, or remove add-on services for a Heroku app.
• Manage Dynos: List running dynos, run one-off dynos, or restart dynos for a Heroku app.
• Manage Log Drains: List, add, or remove log drains for a Heroku app.
• Manage Releases: List releases, get release details, or rollback to a previous release for a Heroku app.
• Get App: Retrieve detailed information about a specific Heroku app by its name or ID.
• Manage Config Vars: Read or update environment configuration variables for a Heroku app.
• Manage Builds: List, get, or create builds for a Heroku app.
• Manage Pipelines: Manage Heroku Pipelines for continuous delivery workflows.
• And 3 more on the Heroku MCP server page.

• Type @ and pick the plugin. The selection applies to that message only, so @mention it again when a follow-up needs fresh Heroku data.
• For write actions, ChatGPT may ask you to confirm first, depending on the app permissions and the action.
• Once published for a workspace, ChatGPT keeps a snapshot of the tool list. When your team adds Heroku tools in Metorial, an admin refreshes the actions in Workspace settings before they appear.
• You can use several apps in one prompt, for example read Heroku data and then create a ticket in another app.

Add custom MCP server is missing

Workspace policy controls it. On Enterprise and Edu, an admin grants the permission to create plugins with MCPs; ask them to enable it for you.

The plugin exists but no tools appear

Creating the plugin is not enough: install it from your plugins, then start a new conversation so ChatGPT loads its tools.

ChatGPT answers without using the tools

Pick the plugin with @ in the composer and name the action you want, for example "use Metorial to look up the latest ticket".

Based on the ChatGPT MCP documentation.