@speakai/mcp-server 1.6.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +57 -9
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -48,14 +48,27 @@ The AI does the searching, summarizing, and citing. Your recordings stay in your
48
48
 
49
49
  1. Open [claude.ai/settings/connectors](https://claude.ai/settings/connectors)
50
50
  2. Click **Add custom connector**
51
- 3. Paste `https://api.speakai.co/v1/mcp`
52
- 4. Click **Add** — a permission popup asks you to log into Speak AI and click **Allow**
53
- 5. Done. Open a new chat and ask about your recordings.
51
+ 3. Name it **Speak AI** and paste `https://api.speakai.co/v1/mcp`, then click **Add**
52
+ 4. A permission popup asks you to log into Speak AI and click **Allow**
53
+ 5. Done — Speak AI shows in your connector list with its tools ready to use. Open a new chat and ask about your recordings.
54
+
55
+ <details>
56
+ <summary>What each step looks like (screenshots)</summary>
57
+
58
+ **3. Add custom connector dialog** — name and URL filled in.
59
+
60
+ ![Claude add custom connector dialog](./assets/claude/1.connector.png)
61
+
62
+ **5. Connected** — Speak AI tools appear in your connector list.
63
+
64
+ ![Speak AI connected in Claude](./assets/claude/2.connected.png)
65
+
66
+ </details>
54
67
 
55
68
  <details>
56
69
  <summary>Developer alternative — manual setup with an API key</summary>
57
70
 
58
- Get a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys), then in step 3 expand **Custom headers** and add `Authorization` = `Bearer <your-key>` before clicking Add.
71
+ Get a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys), then in step 3 expand **Advanced settings** and add `Authorization` = `Bearer <your-key>` before clicking Add.
59
72
 
60
73
  </details>
61
74
 
@@ -79,11 +92,46 @@ Then click Add.
79
92
 
80
93
  ### ChatGPT
81
94
 
82
- 1. Open ChatGPT → **Settings → Connectors → Advanced**
83
- 2. Enable **"Allow custom apps"** (OpenAI calls this toggle "Developer Mode" — but you don't need to be a developer to flip it; it just tells ChatGPT you'd like to add a third-party app like Speak AI)
84
- 3. Click **Create**, paste `https://api.speakai.co/v1/mcp`
85
- 4. Choose the sign-in option when prompted, then sign in to Speak AI and click **Allow** on the permission popup
86
- 5. Per-chat: open a chat, click the connector menu, and enable **Speak AI** for that chat.
95
+ 1. Open ChatGPT → **Settings → Apps & Connectors → Advanced**
96
+ 2. Turn on **Developer Mode** (required while Speak AI isn't yet listed in ChatGPT's app store — this lets you add it as a custom app)
97
+ 3. Back on **Apps & Connectors**, click **Create** and paste `https://api.speakai.co/v1/mcp`
98
+ 4. For **Authentication**, choose **OAuth**
99
+ 5. ChatGPT opens a new tab to Speak AI — sign in (or click **Confirm** if already logged in) to authorize. You'll be redirected back; close the tab and return to ChatGPT.
100
+ 6. **Per-chat:** open a chat, click the **+** / connector menu, and enable **Speak AI** for that chat.
101
+
102
+ <details>
103
+ <summary>What each step looks like (screenshots)</summary>
104
+
105
+ **1. Connect screen in ChatGPT** — paste the connector URL and pick OAuth.
106
+
107
+ ![ChatGPT connect screen](./assets/openai/1.connect.png)
108
+
109
+ **2. Confirm and continue** — ChatGPT asks you to continue to Speak AI.
110
+
111
+ ![ChatGPT continue to Speak](./assets/openai/2.connect-continue.png)
112
+
113
+ **3. Authorize on Speak AI** — sign in or click Confirm if you're already signed in.
114
+
115
+ ![Speak AI authorization screen](./assets/openai/3.speak-auth.png)
116
+
117
+ **4. Connected** — Speak AI now shows in your ChatGPT connector list.
118
+
119
+ ![Speak AI connected in ChatGPT](./assets/openai/4.connected.png)
120
+
121
+ </details>
122
+
123
+ <details>
124
+ <summary>Trouble connecting?</summary>
125
+
126
+ A few things we've seen during early access:
127
+
128
+ - **Authorization tab doesn't show a "you're connected" page** — if you land on the plain Speak AI dashboard with no confirmation, the authorization still went through. Close that tab and return to ChatGPT.
129
+ - **"Connect" button keeps reopening the dashboard** — fully close and reopen ChatGPT, then check **Settings → Apps & Connectors**. Speak AI should already be listed there.
130
+ - **"No actions available" inside a chat** — make sure Developer Mode is still on, and that you've enabled Speak AI from the per-chat connector menu (step 6 above).
131
+
132
+ Still stuck? Email [accounts@speakai.co](mailto:accounts@speakai.co).
133
+
134
+ </details>
87
135
 
88
136
  ### Claude Code (terminal)
89
137
 
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "1.6.0",
3
+ "version": "1.6.1",
4
4
  "mcpName": "io.github.speakai/mcp-server",
5
- "description": "Official Speak AI MCP Server — connect Claude and other AI assistants to Speak AI's transcription, insights, and media management API",
5
+ "description": "Official Speak AI MCP Server — capture meetings, search thousands of recordings, run async voice and video surveys, create clips, and automate workflows from your AI assistant.",
6
6
  "homepage": "https://mcp.speakai.co",
7
7
  "repository": {
8
8
  "type": "git",