Skip to main content

​
Response ChatGPT App Guide

This guide walks through building the widget, running the MCP server, and connecting it to ChatGPT.

​
1) Build the widget assets

git clone https://github.com/stateset/stateset-response-chatgpt-app.git
cd stateset-response-chatgpt-app
pnpm install
pnpm run build
The build emits stateset-response.html/js/css inside assets/.

​
2) Run the MCP server

cd server
pnpm install
STATESET_API_BASE_URL=https://api.stateset.com \
STATESET_API_KEY=sk-... \
pnpm start
Without credentials, the server uses sample data for local testing.

​
3) Expose the MCP server

Use a tunnel to expose the SSE endpoint: 
ngrok http 3030
The endpoint becomes <public-url>/mcp.

​
4) Add the connector in ChatGPT

  1. Open ChatGPT → Settings → Developer Mode → Connectors.
  2. Click Add connector, choose MCP via SSE.
  3. Name it Stateset Response.
  4. Paste <public-url>/mcp as the endpoint.
  5. Save and confirm the connector is online.

​
5) Test the app

@Stateset Response open the customer support workspace for org 1234.

​
Troubleshooting

  • Re-run pnpm run build if assets are missing.
  • Verify the tunnel is reachable and SSE is stable.
  • Confirm API credentials when using live data.