BLURT MCP (LOCAL) - ChatGPT Desktop Integration

Check it out, you can ask for latest replies and click on the name of the respondent and ChatGPT opens up a pane showing details about them, wow!

Comprehensive Guide: Local Node.js MCP Server to ChatGPT Desktop via Secure Tunnel

This master document details the complete end-to-end configuration for serving a local Model Context Protocol MCP Node.js application to the ChatGPT Desktop app on Windows using the official OpenAI Secure Tunnel Client binary.

---

🛠️ Project Architecture & Specs Project Location: C:\npm\blurt-mcp-server Local App Engine: Port 3000 running on route Required Files: tunnel-client.exe downloaded from the official OpenAI GitHub placed directly inside the project root folder.

---

🛰️ Step 1: Provision the Tunnel on the OpenAI Platform Before running any code locally, you must generate a unique tracking ID from the developer console to act as your secure routing endpoint.

1. Navigate to the OpenAI Platform Tunnels Dashboard . 2. Click Create Tunnel . 3. Name/Description: Enter a recognizable tag e.g., Blurt-Local-Bridge . 4. Workspace ID: Leave this field completely blank for personal accounts or input your org- identifier if prompted. 5. Click Save and copy the generated Tunnel ID it will look like tunnel abc123... .

---

🔒 Step 2: Securely Store Your Secret Key One-Time Setup To prevent accidentally leaking your highly sensitive OpenAI secret API key for example, if you push your code to a public GitHub repository , save it to your private Windows user profile memory registry.

1. Click your Windows Start menu, type PowerShell , and open a new terminal window. 2. Paste the following command replace the placeholder text with your actual key starting with sk-proj- : Note: Leave the word 'User' exactly as written. Windows automatically intercepts this string to save it safely inside your specific profile registry hive.

---

📜 Step 3: Create the Automated Launch Script This file sets your variables dynamically, references the path using folder anchors $PSScriptRoot so it can be safely executed from anywhere, and launches your background application.

1. Open Notepad or your preferred text editor and create a new file named start-mcp.ps1 . 2. Save it directly inside your project folder C:\npm\blurt-mcp-server . 3. Copy and paste the exact code script below into the file:

powershell Force the current execution path to match this script file's location Set-Location \$PSScriptRoot

1. Spin up your local npm application in a separate persistent window with correct folder context Start-Process powershell -ArgumentList "-NoExit", "-Command", "Set-Location '\$PSScriptRoot'; npm run start"

2. Wait 5 seconds to let the npm application fully initialize and start listening on its port Start-Sleep -Seconds 5

3. Read your secure API key dynamically from your private Windows user profile memory \$env:CONTROL PLANE API KEY = System.Environment ::GetEnvironmentVariable 'CONTROL PLANE API KEY', 'User'

4. Bind your specific OpenAI Tunnel ID \$env:CONTROL PLANE TUNNEL ID="tunnel YOUR ACTUAL TUNNEL ID"

5. Execute the compiled tunnel client binary Write-Host "Launching OpenAI Tunnel Client Securely..." -ForegroundColor Green .\tunnel-client.exe run --mcp-server-url "

---

🚀 Step 4: Create the 1-Click Desktop Shortcut To completely bypass typing paths and manually turning on security scripts in PowerShell, configure a native Windows shortcut on your desktop:

1. Right-click on an empty space on your Windows Desktop and select New → Shortcut . 2. Paste this exact instruction line into the Target location text box: 3. Click Next , name the shortcut Launch Blurt MCP Tunnel , and click Finish . 4. Right-click your new desktop shortcut icon and select Properties . 5. Locate the Start in text input box and make sure it is completely blank the Target command string takes care of path resolution natively . 6. Click the Advanced... button, check the box that says Run as administrator , and click OK / Apply .

---

🔗 Step 5: Add the Connector to ChatGPT Desktop Now that your local machine is broadcasting, configure the client application to listen for your pipeline.

1. Open your ChatGPT Desktop Application . 2. Click your profile avatar/name and navigate to Settings → Apps & Connectors . 3. Under the Connectors workspace header, click the Create button. 4. Fill out the creation form: Connection Type: Choose Tunnel from the drop-down selector menu. Tunnel ID: Select your newly created tunnel abc123... ID from the pop-up list. Name & Description: Label it something recognizable e.g., Blurt Server Tools . 5. Click Create to permanently bind the bridge connector to your app profile.

---

💬 Step 6: Daily Workflow Execution Every time you want to build or talk with your local app, use this quick checklist:

1. Double-click your Launch Blurt MCP Tunnel desktop shortcut icon and click Yes on the Windows clearance prompt. 2. Two windows will appear: one running your npm run start logs, and one displaying the tunnel line output. Wait until you see registering tools and resource . 3. Open a conversation in ChatGPT Desktop . Make sure you are using an advanced premier reasoning engine model like GPT-4o or o1 , as standard entry tiers like GPT-4o-mini do not support developer connectors. 4. Click the + Attachment/Tools button sitting directly inside your chat text box. 5. Select More / Explore Actions and click the checkbox next to your custom app to add it as an active inline tool for the session. 6. Issue your commands directly to ChatGPT! You will immediately see execution paths and tool call requests flashing actively inside your PowerShell window logs.

Komentarze

Ładuję komentarze…