@agent-native/core 0.106.2 → 0.107.0

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 (240) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +19 -0
  3. package/corpus/core/docs/content/external-agents.mdx +8 -0
  4. package/corpus/core/docs/content/integrations.mdx +597 -0
  5. package/corpus/core/docs/content/locales/ar-SA/external-agents.mdx +7 -0
  6. package/corpus/core/docs/content/locales/ar-SA/mcp-clients.mdx +19 -1
  7. package/corpus/core/docs/content/locales/ar-SA/mcp-protocol.mdx +7 -0
  8. package/corpus/core/docs/content/locales/de-DE/external-agents.mdx +9 -0
  9. package/corpus/core/docs/content/locales/de-DE/mcp-clients.mdx +22 -1
  10. package/corpus/core/docs/content/locales/de-DE/mcp-protocol.mdx +9 -0
  11. package/corpus/core/docs/content/locales/es-ES/external-agents.mdx +9 -0
  12. package/corpus/core/docs/content/locales/es-ES/mcp-clients.mdx +23 -1
  13. package/corpus/core/docs/content/locales/es-ES/mcp-protocol.mdx +9 -0
  14. package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx +9 -0
  15. package/corpus/core/docs/content/locales/fr-FR/mcp-clients.mdx +23 -1
  16. package/corpus/core/docs/content/locales/fr-FR/mcp-protocol.mdx +9 -0
  17. package/corpus/core/docs/content/locales/hi-IN/external-agents.mdx +8 -0
  18. package/corpus/core/docs/content/locales/hi-IN/mcp-clients.mdx +22 -1
  19. package/corpus/core/docs/content/locales/hi-IN/mcp-protocol.mdx +8 -0
  20. package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx +8 -0
  21. package/corpus/core/docs/content/locales/ja-JP/mcp-clients.mdx +21 -1
  22. package/corpus/core/docs/content/locales/ja-JP/mcp-protocol.mdx +8 -0
  23. package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx +8 -0
  24. package/corpus/core/docs/content/locales/ko-KR/mcp-clients.mdx +20 -1
  25. package/corpus/core/docs/content/locales/ko-KR/mcp-protocol.mdx +8 -0
  26. package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx +9 -0
  27. package/corpus/core/docs/content/locales/pt-BR/mcp-clients.mdx +22 -1
  28. package/corpus/core/docs/content/locales/pt-BR/mcp-protocol.mdx +9 -0
  29. package/corpus/core/docs/content/locales/zh-CN/external-agents.mdx +6 -0
  30. package/corpus/core/docs/content/locales/zh-CN/mcp-clients.mdx +17 -1
  31. package/corpus/core/docs/content/locales/zh-CN/mcp-protocol.mdx +6 -0
  32. package/corpus/core/docs/content/locales/zh-TW/external-agents.mdx +6 -0
  33. package/corpus/core/docs/content/locales/zh-TW/mcp-clients.mdx +17 -1
  34. package/corpus/core/docs/content/locales/zh-TW/mcp-protocol.mdx +6 -0
  35. package/corpus/core/docs/content/mcp-clients.mdx +51 -1
  36. package/corpus/core/docs/content/mcp-protocol.mdx +8 -0
  37. package/corpus/core/docs/content/organizations-teams-permissions.mdx +413 -0
  38. package/corpus/core/package.json +1 -1
  39. package/corpus/core/src/client/AssistantChat.tsx +13 -1
  40. package/corpus/core/src/client/chat/message-components.tsx +41 -0
  41. package/corpus/core/src/client/composer/TiptapComposer.tsx +45 -8
  42. package/corpus/core/src/client/integrations/IntegrationsPanel.tsx +30 -11
  43. package/corpus/core/src/client/resources/McpConnectionSuggestion.tsx +240 -0
  44. package/corpus/core/src/client/resources/McpIntegrationDialog.tsx +159 -40
  45. package/corpus/core/src/client/resources/mcp-integration-catalog.ts +433 -4
  46. package/corpus/core/src/client/resources/mcp-integration-logos.ts +108 -0
  47. package/corpus/core/src/deploy/build.ts +32 -0
  48. package/corpus/core/src/extensions/html-shell.ts +33 -1
  49. package/corpus/core/src/ingestion/office.ts +1 -2
  50. package/corpus/core/src/ingestion/pptx.ts +2 -4
  51. package/corpus/core/src/localization/default-messages.ts +126 -1
  52. package/corpus/core/src/mcp/actions/call-mcp-tool.ts +1 -0
  53. package/corpus/core/src/mcp/builtin-tools.ts +115 -10
  54. package/corpus/core/src/server/index.ts +4 -0
  55. package/corpus/core/src/server/org-admin.ts +28 -0
  56. package/corpus/core/src/templates/workspace-core/.agents/skills/extensions/SKILL.md +9 -0
  57. package/corpus/core/src/templates/workspace-core/.agents/skills/extensions/references/api.md +31 -0
  58. package/corpus/core/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +9 -0
  59. package/corpus/templates/analytics/.agents/skills/creative-context/SKILL.md +64 -0
  60. package/corpus/templates/analytics/AGENTS.md +5 -0
  61. package/corpus/templates/analytics/actions/clone-creative-context-dashboard.ts +86 -0
  62. package/corpus/templates/analytics/app/components/layout/Layout.tsx +2 -0
  63. package/corpus/templates/analytics/app/i18n/zh-TW.ts +1 -0
  64. package/corpus/templates/analytics/app/i18n-data.ts +1 -0
  65. package/corpus/templates/analytics/app/pages/Ask.tsx +8 -4
  66. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/index.tsx +59 -0
  67. package/corpus/templates/analytics/app/routes/agent.tsx +7 -1
  68. package/corpus/templates/analytics/changelog/2026-07-17-library-now-flags-published-dashboards-with-newer-versions-a.md +6 -0
  69. package/corpus/templates/analytics/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md +6 -0
  70. package/corpus/templates/analytics/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md +6 -0
  71. package/corpus/templates/analytics/package.json +1 -0
  72. package/corpus/templates/analytics/server/lib/native-creative-context.ts +158 -0
  73. package/corpus/templates/analytics/server/plugins/creative-context.ts +10 -0
  74. package/corpus/templates/assets/.agents/skills/creative-context/SKILL.md +12 -3
  75. package/corpus/templates/assets/AGENTS.md +5 -0
  76. package/corpus/templates/assets/actions/clone-creative-context-asset.ts +74 -0
  77. package/corpus/templates/assets/app/hooks/use-navigation-state.ts +2 -1
  78. package/corpus/templates/assets/app/routes/brand-kits.$id.tsx +308 -178
  79. package/corpus/templates/assets/app/routes/library.tsx +5 -11
  80. package/corpus/templates/assets/changelog/2026-07-17-library-now-flags-published-assets-with-newer-versions-and-l.md +6 -0
  81. package/corpus/templates/assets/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md +6 -0
  82. package/corpus/templates/assets/server/lib/native-creative-context.ts +198 -0
  83. package/corpus/templates/assets/server/plugins/creative-context.ts +4 -0
  84. package/corpus/templates/brain/actions/provider-api-request.ts +1 -0
  85. package/corpus/templates/calendar/actions/provider-api-request.ts +1 -0
  86. package/corpus/templates/clips/actions/get-recording-insights.ts +7 -4
  87. package/corpus/templates/clips/actions/list-recordings.ts +48 -0
  88. package/corpus/templates/clips/actions/list-viewers.ts +2 -1
  89. package/corpus/templates/clips/app/components/editor/stitch-manager.tsx +3 -1
  90. package/corpus/templates/clips/app/components/player/share-dialog.tsx +1 -3
  91. package/corpus/templates/clips/app/hooks/use-desktop-promo.ts +11 -6
  92. package/corpus/templates/clips/app/hooks/use-view-tracking.ts +6 -1
  93. package/corpus/templates/clips/app/lib/ffmpeg-export.ts +4 -2
  94. package/corpus/templates/clips/app/routes/share.$shareId.tsx +21 -3
  95. package/corpus/templates/clips/changelog/2026-07-17-dictation-keeps-sentence-spacing-and-no-longer-crashes-when-.md +6 -0
  96. package/corpus/templates/clips/changelog/2026-07-17-shared-clips-now-preserve-editor-access-and-show-editor-insi.md +6 -0
  97. package/corpus/templates/clips/changelog/2026-07-17-stitching-clips-no-longer-fails-when-editor-media-metadata-i.md +6 -0
  98. package/corpus/templates/clips/server/routes/api/public-recording.get.ts +14 -8
  99. package/corpus/templates/clips/shared/view-analytics.ts +4 -0
  100. package/corpus/templates/content/.agents/skills/creative-context/SKILL.md +12 -3
  101. package/corpus/templates/content/AGENTS.md +5 -0
  102. package/corpus/templates/content/actions/clone-creative-context-document.ts +61 -0
  103. package/corpus/templates/content/actions/provider-api-request.ts +1 -0
  104. package/corpus/templates/content/app/components/editor/DocumentToolbar.tsx +21 -0
  105. package/corpus/templates/content/app/components/sidebar/DocumentTreeItem.tsx +29 -0
  106. package/corpus/templates/content/changelog/2026-07-17-library-now-flags-published-documents-with-newer-versions-an.md +6 -0
  107. package/corpus/templates/content/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md +6 -0
  108. package/corpus/templates/content/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md +6 -0
  109. package/corpus/templates/content/parity/matrix.md +1 -1
  110. package/corpus/templates/content/parity/matrix.ts +1 -0
  111. package/corpus/templates/content/server/lib/native-creative-context.ts +191 -0
  112. package/corpus/templates/content/server/plugins/creative-context.ts +8 -1
  113. package/corpus/templates/design/.agents/skills/creative-context/SKILL.md +11 -3
  114. package/corpus/templates/design/AGENTS.md +5 -0
  115. package/corpus/templates/design/actions/clone-creative-context-design-native.ts +111 -0
  116. package/corpus/templates/design/actions/provider-api-request.ts +1 -0
  117. package/corpus/templates/design/app/pages/Index.tsx +44 -0
  118. package/corpus/templates/design/app/pages/design-editor/types.ts +1 -0
  119. package/corpus/templates/design/changelog/2026-07-17-library-now-flags-published-designs-with-newer-versions-and-.md +6 -0
  120. package/corpus/templates/design/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md +6 -0
  121. package/corpus/templates/design/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md +6 -0
  122. package/corpus/templates/design/server/lib/native-creative-context.ts +265 -0
  123. package/corpus/templates/design/server/plugins/creative-context.ts +8 -1
  124. package/corpus/templates/dispatch/actions/provider-api-request.ts +1 -0
  125. package/corpus/templates/mail/actions/provider-api-request.ts +1 -0
  126. package/corpus/templates/slides/.agents/skills/creative-context/SKILL.md +11 -3
  127. package/corpus/templates/slides/AGENTS.md +5 -0
  128. package/corpus/templates/slides/actions/clone-creative-context-deck.ts +96 -0
  129. package/corpus/templates/slides/actions/extract-pdf.ts +3 -2
  130. package/corpus/templates/slides/actions/import-file.ts +3 -2
  131. package/corpus/templates/slides/actions/provider-api-request.ts +1 -0
  132. package/corpus/templates/slides/app/components/deck/DeckCard.tsx +27 -0
  133. package/corpus/templates/slides/app/components/editor/EditorToolbar.tsx +21 -0
  134. package/corpus/templates/slides/changelog/2026-07-17-library-now-flags-published-decks-with-newer-versions-and-le.md +6 -0
  135. package/corpus/templates/slides/changelog/2026-07-17-pdf-and-powerpoint-imports-now-work-reliably-in-hosted-decks.md +6 -0
  136. package/corpus/templates/slides/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md +6 -0
  137. package/corpus/templates/slides/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md +6 -0
  138. package/corpus/templates/slides/server/lib/native-creative-context.ts +288 -0
  139. package/corpus/templates/slides/server/plugins/creative-context.ts +4 -0
  140. package/dist/client/AssistantChat.d.ts.map +1 -1
  141. package/dist/client/AssistantChat.js +8 -2
  142. package/dist/client/AssistantChat.js.map +1 -1
  143. package/dist/client/chat/message-components.d.ts.map +1 -1
  144. package/dist/client/chat/message-components.js +35 -1
  145. package/dist/client/chat/message-components.js.map +1 -1
  146. package/dist/client/composer/TiptapComposer.d.ts +7 -0
  147. package/dist/client/composer/TiptapComposer.d.ts.map +1 -1
  148. package/dist/client/composer/TiptapComposer.js +37 -8
  149. package/dist/client/composer/TiptapComposer.js.map +1 -1
  150. package/dist/client/integrations/IntegrationsPanel.d.ts.map +1 -1
  151. package/dist/client/integrations/IntegrationsPanel.js +3 -2
  152. package/dist/client/integrations/IntegrationsPanel.js.map +1 -1
  153. package/dist/client/resources/McpConnectionSuggestion.d.ts +9 -0
  154. package/dist/client/resources/McpConnectionSuggestion.d.ts.map +1 -0
  155. package/dist/client/resources/McpConnectionSuggestion.js +115 -0
  156. package/dist/client/resources/McpConnectionSuggestion.js.map +1 -0
  157. package/dist/client/resources/McpIntegrationDialog.d.ts +2 -1
  158. package/dist/client/resources/McpIntegrationDialog.d.ts.map +1 -1
  159. package/dist/client/resources/McpIntegrationDialog.js +48 -20
  160. package/dist/client/resources/McpIntegrationDialog.js.map +1 -1
  161. package/dist/client/resources/mcp-integration-catalog.d.ts +9 -0
  162. package/dist/client/resources/mcp-integration-catalog.d.ts.map +1 -1
  163. package/dist/client/resources/mcp-integration-catalog.js +387 -4
  164. package/dist/client/resources/mcp-integration-catalog.js.map +1 -1
  165. package/dist/client/resources/mcp-integration-logos.d.ts +2 -0
  166. package/dist/client/resources/mcp-integration-logos.d.ts.map +1 -0
  167. package/dist/client/resources/mcp-integration-logos.js +109 -0
  168. package/dist/client/resources/mcp-integration-logos.js.map +1 -0
  169. package/dist/deploy/build.d.ts.map +1 -1
  170. package/dist/deploy/build.js +23 -0
  171. package/dist/deploy/build.js.map +1 -1
  172. package/dist/extensions/html-shell.d.ts.map +1 -1
  173. package/dist/extensions/html-shell.js +33 -1
  174. package/dist/extensions/html-shell.js.map +1 -1
  175. package/dist/ingestion/office.d.ts.map +1 -1
  176. package/dist/ingestion/office.js +1 -2
  177. package/dist/ingestion/office.js.map +1 -1
  178. package/dist/ingestion/pptx.js +2 -4
  179. package/dist/ingestion/pptx.js.map +1 -1
  180. package/dist/localization/default-messages.d.ts +98 -0
  181. package/dist/localization/default-messages.d.ts.map +1 -1
  182. package/dist/localization/default-messages.js +99 -1
  183. package/dist/localization/default-messages.js.map +1 -1
  184. package/dist/mcp/actions/call-mcp-tool.js +1 -0
  185. package/dist/mcp/actions/call-mcp-tool.js.map +1 -1
  186. package/dist/mcp/builtin-tools.d.ts.map +1 -1
  187. package/dist/mcp/builtin-tools.js +87 -6
  188. package/dist/mcp/builtin-tools.js.map +1 -1
  189. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  190. package/dist/server/index.d.ts +1 -0
  191. package/dist/server/index.d.ts.map +1 -1
  192. package/dist/server/index.js +1 -0
  193. package/dist/server/index.js.map +1 -1
  194. package/dist/server/org-admin.d.ts +3 -0
  195. package/dist/server/org-admin.d.ts.map +1 -0
  196. package/dist/server/org-admin.js +24 -0
  197. package/dist/server/org-admin.js.map +1 -0
  198. package/dist/server/transcribe-voice.d.ts +1 -1
  199. package/dist/templates/workspace-core/.agents/skills/extensions/SKILL.md +9 -0
  200. package/dist/templates/workspace-core/.agents/skills/extensions/references/api.md +31 -0
  201. package/dist/templates/workspace-core/.agents/skills/external-agents/SKILL.md +9 -0
  202. package/docs/content/external-agents.mdx +8 -0
  203. package/docs/content/integrations.mdx +597 -0
  204. package/docs/content/locales/ar-SA/external-agents.mdx +7 -0
  205. package/docs/content/locales/ar-SA/mcp-clients.mdx +19 -1
  206. package/docs/content/locales/ar-SA/mcp-protocol.mdx +7 -0
  207. package/docs/content/locales/de-DE/external-agents.mdx +9 -0
  208. package/docs/content/locales/de-DE/mcp-clients.mdx +22 -1
  209. package/docs/content/locales/de-DE/mcp-protocol.mdx +9 -0
  210. package/docs/content/locales/es-ES/external-agents.mdx +9 -0
  211. package/docs/content/locales/es-ES/mcp-clients.mdx +23 -1
  212. package/docs/content/locales/es-ES/mcp-protocol.mdx +9 -0
  213. package/docs/content/locales/fr-FR/external-agents.mdx +9 -0
  214. package/docs/content/locales/fr-FR/mcp-clients.mdx +23 -1
  215. package/docs/content/locales/fr-FR/mcp-protocol.mdx +9 -0
  216. package/docs/content/locales/hi-IN/external-agents.mdx +8 -0
  217. package/docs/content/locales/hi-IN/mcp-clients.mdx +22 -1
  218. package/docs/content/locales/hi-IN/mcp-protocol.mdx +8 -0
  219. package/docs/content/locales/ja-JP/external-agents.mdx +8 -0
  220. package/docs/content/locales/ja-JP/mcp-clients.mdx +21 -1
  221. package/docs/content/locales/ja-JP/mcp-protocol.mdx +8 -0
  222. package/docs/content/locales/ko-KR/external-agents.mdx +8 -0
  223. package/docs/content/locales/ko-KR/mcp-clients.mdx +20 -1
  224. package/docs/content/locales/ko-KR/mcp-protocol.mdx +8 -0
  225. package/docs/content/locales/pt-BR/external-agents.mdx +9 -0
  226. package/docs/content/locales/pt-BR/mcp-clients.mdx +22 -1
  227. package/docs/content/locales/pt-BR/mcp-protocol.mdx +9 -0
  228. package/docs/content/locales/zh-CN/external-agents.mdx +6 -0
  229. package/docs/content/locales/zh-CN/mcp-clients.mdx +17 -1
  230. package/docs/content/locales/zh-CN/mcp-protocol.mdx +6 -0
  231. package/docs/content/locales/zh-TW/external-agents.mdx +6 -0
  232. package/docs/content/locales/zh-TW/mcp-clients.mdx +17 -1
  233. package/docs/content/locales/zh-TW/mcp-protocol.mdx +6 -0
  234. package/docs/content/mcp-clients.mdx +51 -1
  235. package/docs/content/mcp-protocol.mdx +8 -0
  236. package/docs/content/organizations-teams-permissions.mdx +413 -0
  237. package/package.json +1 -1
  238. package/src/templates/workspace-core/.agents/skills/extensions/SKILL.md +9 -0
  239. package/src/templates/workspace-core/.agents/skills/extensions/references/api.md +31 -0
  240. package/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +9 -0
@@ -530,6 +530,15 @@ Für schnelle ChatGPT/Claude-Übergaben ist der ideale Pfad direkt: Rufen Sie di
530
530
 
531
531
  MCP-Hosts und -Gateways teilen sich kein einheitliches Zeitlimit für Tool-Aufrufe; manche erzwingen eine Obergrenze von fünf Minuten, andere sind konfigurierbar. Planen Sie eine externe Agentenintegration nicht um einen zehnminütigen, blockierenden `tools/call` herum. `ask-agent` und `ask_app` bestätigen gehostete Arbeit schnell und geben dann eine dauerhafte `taskId` zurück, sobald die Inline-Wartezeit abläuft. Fragen Sie mit `ask_app_status` unter Verwendung der zurückgegebenen `app` und `taskId` ab; das Ergebnis enthält `pollAfterMs` als host-freundliches Intervall. Die Aufgabe muss erstellt werden, bevor die erste Antwort in ein Timeout laufen kann – eine Polling-URL, die erst nach einem langen Aufruf zurückgegeben wird, ist kein zuverlässiger Recovery-Vertrag.
532
532
 
533
+ Ist ein begrenzter, vorübergehender Statusabruf nicht verfügbar, kann
534
+ `ask_app_status` `status: "unknown"`, `statusRead: "unavailable"` und
535
+ `retryable: true` sowie das ursprüngliche `app`, `taskId` und `pollAfterMs` /
536
+ `poll` zurückgeben. Das bedeutet, dass der Statusabruf nicht verfügbar ist –
537
+ nicht, dass die dauerhafte Aufgabe fehlgeschlagen ist. Wiederholen Sie
538
+ `ask_app_status` mit genau demselben `app` und `taskId`; reichen Sie zur
539
+ Wiederherstellung niemals erneut `ask_app` ein, da dies Arbeit duplizieren kann.
540
+ Dauerhafte Authentifizierungs-, Nicht-gefunden- und Protokollfehler bleiben Fehler.
541
+
533
542
  ### Tour pro App {#tour}
534
543
 
535
544
  Jede Vorlage auf der Zulassungsliste, die eine navigierbare Ressource erstellt oder auflistet, liefert einen `link`-Builder, und die aufnahmeintensiven Vorlagen liefern eine GET + `publicAgent`-Aktion, damit ein verbundener Agent den Live-Status abrufen kann:
@@ -246,7 +246,28 @@ Das bedeutet, dass Benutzer, die die Claude-in-Chrome-Erweiterung installiert ha
246
246
  MCP-Server (Model Context Protocol) geben Ihrem Agenten neue Fähigkeiten – wie die Verbindung zu Zapier, Cloudflare, Composio oder den internen Tools Ihres Unternehmens. Sobald die Verbindung hergestellt ist, kann der Agent diese Tools genauso verwenden wie die integrierten.
247
247
 
248
248
  Die Preset-IDs sind `context7`, `sentry`, `notion`, `semgrep`, `linear`,
249
- `atlassian`, `supabase`, `neon` und `stripe`.
249
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
250
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify` und `zapier`.
251
+
252
+ Das Verzeichnis unterscheidet Endpunkte mit dem generischen OAuth-Ablauf von
253
+ Anbietern, die einen vom Anbieter genehmigten Client oder eine vorab registrierte
254
+ OAuth-Anwendung benötigen. Solche Einträge bleiben zur Entdeckung sichtbar und
255
+ verlinken auf die offiziellen Einrichtungsanweisungen, zeigen aber keinen
256
+ irreführenden Ein-Klick-Verbindungsbutton. Sandboxed Erweiterungen verwenden
257
+ `agentNative.mcp.listTools`, `agentNative.mcp.callTool` sowie
258
+ `agentNative.providerApi.catalog(...)` und `agentNative.providerApi.docs(...)`
259
+ über die Host-Aktionen, um verbundene Daten zu ermitteln; Verbindungs-URLs,
260
+ Zugriffs- und Refresh-Tokens werden ihnen niemals übergeben. Der rohe
261
+ `provider-api-request`-Aufruf bleibt bewusst dem Host und dem Agenten
262
+ vorbehalten: Stünde er beliebigen Methoden-/Pfad-Anfragen gemeinsam genutzter
263
+ Erweiterungen offen, könnte eine Erweiterung zu einem authentifizierten
264
+ Schreib-Proxy werden. Erweiterungen sollten stattdessen `agentNative.mcp.callTool(...)`
265
+ oder eine dafür vorgesehene App-Aktion für begrenzte Anbieteroperationen verwenden.
266
+
267
+ Lokale Datei-Erweiterungen müssen `list-mcp-tools`, `call-mcp-tool` und jede
268
+ unterstützte Anbieteraktion, die sie verwenden, ausdrücklich in `extension.json`
269
+ freigeben. Die Discovery-Helfer sind auch unter `agentNative.connectors.mcp`
270
+ und `agentNative.connectors.providerApi` verfügbar.
250
271
 
251
272
  ### Atlassian / Jira
252
273
 
@@ -231,6 +231,15 @@ Der Agent führt die gleiche Schleife aus wie der interaktive Chat – er kann m
231
231
 
232
232
  Rufen Sie `ask_app_status` mit diesen Argumenten auf, bis die Aufgabe einen Endzustand erreicht. Das app-eigene `ask_app` von Dispatch verwendet denselben Vertrag für dauerhafte Aufgaben und Status, wobei die Berechtigung für die ausgewählte App sowohl bei der Übermittlung als auch beim Polling geprüft wird.
233
233
 
234
+ Ist ein begrenzter, vorübergehender Statusabruf nicht verfügbar, kann
235
+ `ask_app_status` `status: "unknown"`, `statusRead: "unavailable"` und
236
+ `retryable: true` sowie das ursprüngliche `app`, `taskId` und `pollAfterMs` /
237
+ `poll` zurückgeben. Das bedeutet, dass der Statusabruf nicht verfügbar ist –
238
+ nicht, dass die dauerhafte Aufgabe fehlgeschlagen ist. Wiederholen Sie
239
+ `ask_app_status` mit genau demselben `app` und `taskId`; reichen Sie zur
240
+ Wiederherstellung niemals erneut `ask_app` ein, da dies Arbeit duplizieren kann.
241
+ Dauerhafte Authentifizierungs-, Nicht-gefunden- und Protokollfehler bleiben Fehler.
242
+
234
243
  ## Authentifizierung {#authentication}
235
244
 
236
245
  Der MCP-Endpunkt unterstützt den Standard-Remote-MCP OAuth sowie den vorhandenen Bearer-Token-Fallback:
@@ -539,6 +539,15 @@ para hosts. La tarea debe crearse antes de que la primera respuesta pueda
539
539
  agotar el tiempo de espera, por lo que una URL de sondeo devuelta solo después
540
540
  de una llamada larga no es un contrato de recuperación confiable.
541
541
 
542
+ Si no está disponible una lectura de estado transitoria y acotada,
543
+ `ask_app_status` puede devolver `status: "unknown"`,
544
+ `statusRead: "unavailable"`, `retryable: true`, el `app` y `taskId` originales,
545
+ y `pollAfterMs` / `poll`. Esto significa que la lectura de estado no está
546
+ disponible, no que la tarea duradera haya fallado. Vuelva a intentar
547
+ `ask_app_status` con exactamente el mismo `app` y `taskId`; nunca reenvíe
548
+ `ask_app` para recuperarse, porque el envío puede duplicar el trabajo. Los errores
549
+ permanentes de autenticación, de no encontrado y de protocolo siguen siendo errores.
550
+
542
551
  ### Recorrido por aplicación {#tour}
543
552
 
544
553
  Cada plantilla incluida en la lista permitida que produce o enumera un recurso navegable incluye un generador `link`, y las de ingesta pesada incluyen una acción GET + `publicAgent` para que un agente conectado pueda obtener el estado en vivo:
@@ -247,7 +247,29 @@ Esto significa que los usuarios que han instalado la extensión claude-in-chrome
247
247
  Los servidores MCP (Protocolo de contexto modelo) le brindan a su agente nuevas capacidades, como conectarse a Zapier, Cloudflare, Composio o las herramientas internas de su empresa. Una vez conectado, el agente puede utilizar esas herramientas al igual que las integradas.
248
248
 
249
249
  Los identificadores de los ajustes preestablecidos son `context7`, `sentry`, `notion`, `semgrep`, `linear`,
250
- `atlassian`, `supabase`, `neon` y `stripe`.
250
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
251
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify` y `zapier`.
252
+
253
+ El directorio distingue los puntos de conexión que admiten el flujo OAuth
254
+ genérico de los proveedores que requieren un cliente aprobado por el proveedor
255
+ o una aplicación OAuth registrada previamente. Estos últimos siguen visibles
256
+ para su descubrimiento y enlazan a las instrucciones oficiales, pero no muestran
257
+ un botón de conexión de un clic que pueda resultar engañoso. Las extensiones
258
+ aisladas usan `agentNative.mcp.listTools`, `agentNative.mcp.callTool` y
259
+ `agentNative.providerApi.catalog(...)`/`agentNative.providerApi.docs(...)` a
260
+ través de las acciones del host para descubrir datos conectados; nunca reciben
261
+ URL de conexión, tokens de acceso ni tokens de actualización. La llamada
262
+ directa `provider-api-request` se reserva intencionadamente al host y al
263
+ agente: exponer solicitudes arbitrarias de método/ruta a extensiones
264
+ compartidas convertiría a una extensión en un proxy de escritura autenticado.
265
+ En su lugar, las extensiones deben usar `agentNative.mcp.callTool(...)` o una
266
+ acción de la aplicación creada para ese fin, limitada a operaciones concretas
267
+ del proveedor.
268
+
269
+ Las extensiones locales deben permitir explícitamente `list-mcp-tools`,
270
+ `call-mcp-tool` y cualquier acción de proveedor compatible que utilicen en
271
+ `extension.json`. Los helpers de descubrimiento también están disponibles en
272
+ `agentNative.connectors.mcp` y `agentNative.connectors.providerApi`.
251
273
 
252
274
  ### Atlassian / Jira
253
275
 
@@ -240,6 +240,15 @@ estado terminal. El `ask_app` propio de cada aplicación en Dispatch usa el
240
240
  mismo contrato de tarea y estado duraderos, con la concesión de la aplicación
241
241
  seleccionada verificada tanto en el envío como en el sondeo.
242
242
 
243
+ Si no está disponible una lectura de estado transitoria y acotada,
244
+ `ask_app_status` puede devolver `status: "unknown"`,
245
+ `statusRead: "unavailable"`, `retryable: true`, el `app` y `taskId` originales,
246
+ y `pollAfterMs` / `poll`. Esto significa que la lectura de estado no está
247
+ disponible, no que la tarea duradera haya fallado. Vuelva a intentar
248
+ `ask_app_status` con exactamente el mismo `app` y `taskId`; nunca reenvíe
249
+ `ask_app` para recuperarse, porque el envío puede duplicar el trabajo. Los errores
250
+ permanentes de autenticación, de no encontrado y de protocolo siguen siendo errores.
251
+
243
252
  ## Autenticación {#authentication}
244
253
 
245
254
  El punto final MCP admite MCP OAuth remoto estándar más el respaldo de token de portador existente:
@@ -531,6 +531,15 @@ Pour des transferts rapides ChatGPT/Claude, le chemin idéal est direct : appel
531
531
 
532
532
  Les hôtes et passerelles MCP ne partagent pas un seul et même délai d'expiration pour les appels d'outils : certains imposent un plafond de cinq minutes, d'autres sont configurables. Ne concevez pas une intégration d'agent externe autour d'un `tools/call` bloquant de dix minutes. `ask-agent` et `ask_app` accusent rapidement réception du travail hébergé, puis renvoient un `taskId` durable lorsque l'attente en ligne expire. Interrogez avec `ask_app_status` en utilisant les `app` et `taskId` renvoyés ; le résultat inclut `pollAfterMs` comme intervalle adapté à l'hôte. La tâche doit être créée avant que la première réponse ne puisse expirer, de sorte qu'une URL d'interrogation renvoyée seulement après un long appel n'est pas un contrat de récupération fiable.
533
533
 
534
+ Si une lecture d'état transitoire et limitée est indisponible, `ask_app_status`
535
+ peut renvoyer `status: "unknown"`, `statusRead: "unavailable"`,
536
+ `retryable: true`, les `app` et `taskId` d'origine, ainsi que `pollAfterMs` /
537
+ `poll`. Cela signifie que la lecture d'état est indisponible, et non que la tâche
538
+ durable a échoué. Réessayez `ask_app_status` avec exactement les mêmes `app` et
539
+ `taskId` ; ne soumettez jamais à nouveau `ask_app` pour récupérer, car la
540
+ soumission peut dupliquer le travail. Les erreurs permanentes d'authentification,
541
+ d'introuvable et de protocole restent des erreurs.
542
+
534
543
  ### Visite par application {#tour}
535
544
 
536
545
  Chaque modèle sur liste verte qui produit ou répertorie une ressource navigable est livré avec un générateur `link`, et ceux qui sont lourds à ingérer envoient une action GET + `publicAgent` afin qu'un agent connecté puisse extraire l'état en direct :
@@ -246,7 +246,29 @@ Cela signifie que les utilisateurs qui ont installé l'extension claude-in-chrom
246
246
  Les serveurs MCP (Model Context Protocol) offrent à votre agent de nouvelles capacités, comme la connexion à Zapier, Cloudflare, Composio ou aux outils internes de votre entreprise. Une fois connecté, l'agent peut utiliser ces outils tout comme ses outils intégrés.
247
247
 
248
248
  Les identifiants des préréglages sont `context7`, `sentry`, `notion`, `semgrep`, `linear`,
249
- `atlassian`, `supabase`, `neon` et `stripe`.
249
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
250
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify` et `zapier`.
251
+
252
+ Le répertoire distingue les points de terminaison qui prennent en charge le flux
253
+ OAuth générique des fournisseurs qui exigent un client approuvé par le fournisseur
254
+ ou une application OAuth préenregistrée. Ces entrées restent visibles pour la
255
+ découverte et renvoient vers les instructions officielles, mais n'affichent pas
256
+ de bouton de connexion en un clic trompeur. Les extensions isolées utilisent
257
+ `agentNative.mcp.listTools`, `agentNative.mcp.callTool` ainsi que
258
+ `agentNative.providerApi.catalog(...)` et `agentNative.providerApi.docs(...)`
259
+ via les actions de l'hôte pour découvrir les données connectées ; elles ne
260
+ reçoivent jamais les URL de connexion, les jetons d'accès ni les jetons
261
+ d'actualisation. L'appel brut `provider-api-request` reste volontairement
262
+ réservé à l'hôte et à l'agent : exposer des requêtes arbitraires (méthode/chemin)
263
+ aux extensions partagées transformerait une extension en proxy d'écriture
264
+ authentifié. Les extensions doivent plutôt utiliser `agentNative.mcp.callTool(...)`
265
+ ou une action d'application dédiée pour des opérations de fournisseur limitées
266
+ et bien définies.
267
+
268
+ Les extensions locales doivent autoriser explicitement `list-mcp-tools`,
269
+ `call-mcp-tool` et toute action fournisseur prise en charge qu'elles utilisent
270
+ dans `extension.json`. Les assistants de découverte sont également disponibles
271
+ via `agentNative.connectors.mcp` et `agentNative.connectors.providerApi`.
250
272
 
251
273
  ### Atlassian / Jira
252
274
 
@@ -231,6 +231,15 @@ L'agent exécute la même boucle que le chat interactif : il peut appeler plusi
231
231
 
232
232
  Appelez `ask_app_status` avec ces arguments jusqu'à ce que la tâche atteigne un état terminal. Le `ask_app` propre à l'application de Dispatch utilise le même contrat de tâche durable et de statut, avec la vérification de l'autorisation de l'application sélectionnée effectuée à la fois lors de la soumission et de l'interrogation.
233
233
 
234
+ Si une lecture d'état transitoire et limitée est indisponible, `ask_app_status`
235
+ peut renvoyer `status: "unknown"`, `statusRead: "unavailable"`,
236
+ `retryable: true`, les `app` et `taskId` d'origine, ainsi que `pollAfterMs` /
237
+ `poll`. Cela signifie que la lecture d'état est indisponible, et non que la tâche
238
+ durable a échoué. Réessayez `ask_app_status` avec exactement les mêmes `app` et
239
+ `taskId` ; ne soumettez jamais à nouveau `ask_app` pour récupérer, car la
240
+ soumission peut dupliquer le travail. Les erreurs permanentes d'authentification,
241
+ d'introuvable et de protocole restent des erreurs.
242
+
234
243
  ## Authentification {#authentication}
235
244
 
236
245
  Le point de terminaison MCP prend en charge le modèle distant standard MCP OAuth, ainsi que le remplacement du jeton de support existant :
@@ -535,6 +535,14 @@ MCP होस्ट और गेटवे एक साझा लंबे ट
535
535
  टाइमआउट होने से पहले टास्क बनाया जाना चाहिए, इसलिए केवल लंबे कॉल के बाद
536
536
  लौटाया गया पोलिंग URL एक विश्वसनीय रिकवरी अनुबंध नहीं है।
537
537
 
538
+ यदि सीमित, अस्थायी स्थिति-पठन उपलब्ध नहीं है, तो `ask_app_status`
539
+ `status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, मूल `app`
540
+ और `taskId`, तथा `pollAfterMs` / `poll` लौटा सकता है। इसका अर्थ है कि स्थिति-पठन
541
+ अनुपलब्ध है, न कि स्थायी टास्क विफल हुआ है। ठीक उसी `app` और `taskId` के साथ
542
+ `ask_app_status` को फिर आज़माएँ; पुनर्प्राप्ति के लिए `ask_app` को कभी फिर से सबमिट
543
+ न करें, क्योंकि सबमिशन काम की नकल कर सकता है। स्थायी प्रमाणीकरण, न मिलने और
544
+ प्रोटोकॉल त्रुटियाँ त्रुटियाँ ही रहती हैं।
545
+
538
546
  ### प्रति-ऐप टूर {#tour}
539
547
 
540
548
  प्रत्येक अनुमति-सूचीबद्ध टेम्पलेट जो एक नेविगेशन योग्य संसाधन का उत्पादन या सूचीबद्ध करता है, एक `link` बिल्डर को शिप करता है, और अंतर्ग्रहण-भारी वाले एक GET + `publicAgent` कार्रवाई को शिप करते हैं ताकि एक कनेक्टेड एजेंट लाइव स्थिति खींच सके:
@@ -246,7 +246,28 @@ MCP उपकरण केवल नोड रनटाइम में सक
246
246
  MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर आपके एजेंट को नई क्षमताएं देते हैं - जैसे जैपियर, क्लाउडफ्लेयर, कंपोज़ियो या आपकी कंपनी के आंतरिक टूल से कनेक्ट करना। एक बार कनेक्ट होने के बाद, एजेंट उन टूल्स का उपयोग अपने बिल्ट-इन टूल्स की तरह ही कर सकता है।
247
247
 
248
248
  प्रीसेट आईडी `context7`, `sentry`, `notion`, `semgrep`, `linear`,
249
- `atlassian`, `supabase`, `neon` और `stripe` हैं।
249
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
250
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify` और `zapier` हैं।
251
+
252
+ डायरेक्टरी उन एंडपॉइंट्स को अलग दिखाती है जो सामान्य OAuth फ्लो का समर्थन
253
+ करते हैं और उन प्रदाताओं को भी जो प्रदाता-अनुमोदित क्लाइंट या पहले से पंजीकृत
254
+ OAuth ऐप मांगते हैं। ऐसे प्रदाता खोजने के लिए दिखाई देते हैं और आधिकारिक सेटअप
255
+ निर्देशों से जुड़े होते हैं, लेकिन जहां एक-क्लिक कनेक्शन समर्थित नहीं है वहां
256
+ भ्रामक बटन नहीं दिखाया जाता। सैंडबॉक्स की गई एक्सटेंशन होस्ट एक्शन के जरिए
257
+ `agentNative.mcp.listTools`, `agentNative.mcp.callTool` और
258
+ `agentNative.providerApi.catalog(...)`/`agentNative.providerApi.docs(...)` का
259
+ उपयोग करके कनेक्टेड डेटा खोज सकती हैं; उन्हें कनेक्शन URL, एक्सेस टोकन या
260
+ रीफ्रेश टोकन कभी नहीं मिलते। कच्चा `provider-api-request` जानबूझकर केवल
261
+ होस्ट और एजेंट तक सीमित रखा गया है: यदि साझा की गई एक्सटेंशन को मनमाना
262
+ मेथड/पाथ अनुरोध करने दिया जाए, तो वह एक्सटेंशन एक ऑथेंटिकेटेड राइट प्रॉक्सी
263
+ बन सकती है। इसके बजाय एक्सटेंशन को सीमित-दायरे वाले प्रोवाइडर ऑपरेशन के लिए
264
+ `agentNative.mcp.callTool(...)` या किसी खास उद्देश्य के लिए बनाए गए ऐप एक्शन
265
+ का उपयोग करना चाहिए।
266
+
267
+ लोकल-फ़ाइल एक्सटेंशन को `extension.json` में `list-mcp-tools`, `call-mcp-tool`
268
+ और उनके द्वारा उपयोग की जाने वाली हर समर्थित प्रोवाइडर कार्रवाई को स्पष्ट रूप
269
+ से अनुमति देनी होगी। डिस्कवरी हेल्पर `agentNative.connectors.mcp` और
270
+ `agentNative.connectors.providerApi` के तहत भी उपलब्ध हैं।
250
271
 
251
272
  ### Atlassian / Jira
252
273
 
@@ -238,6 +238,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
238
238
  अनुबंध का उपयोग करता है, जिसमें चयनित-ऐप अनुदान की जांच सबमिशन और पोलिंग दोनों
239
239
  पर की जाती है।
240
240
 
241
+ यदि सीमित, अस्थायी स्थिति-पठन उपलब्ध नहीं है, तो `ask_app_status`
242
+ `status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, मूल `app`
243
+ और `taskId`, तथा `pollAfterMs` / `poll` लौटा सकता है। इसका अर्थ है कि स्थिति-पठन
244
+ अनुपलब्ध है, न कि स्थायी टास्क विफल हुआ है। ठीक उसी `app` और `taskId` के साथ
245
+ `ask_app_status` को फिर आज़माएँ; पुनर्प्राप्ति के लिए `ask_app` को कभी फिर से सबमिट
246
+ न करें, क्योंकि सबमिशन काम की नकल कर सकता है। स्थायी प्रमाणीकरण, न मिलने और
247
+ प्रोटोकॉल त्रुटियाँ त्रुटियाँ ही रहती हैं।
248
+
241
249
  ## प्रमाणीकरण {#authentication}
242
250
 
243
251
  MCP एंडपॉइंट मानक रिमोट MCP OAuth प्लस मौजूदा बियरर-टोकन फ़ॉलबैक का समर्थन करता है:
@@ -528,6 +528,14 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
528
528
 
529
529
  MCP ホストとゲートウェイは、単一の長いツール呼び出しタイムアウトを共有していません。5 分の上限を課すものもあれば、設定可能なものもあります。10 分間ブロックする `tools/call` を前提に外部エージェント連携を設計しないでください。 `ask-agent` と `ask_app` はホストされている処理をすぐに確認応答し、インライン待機が期限切れになると永続的な `taskId` を返します。返された `app` と `taskId` を使用して `ask_app_status` でポーリングしてください。結果にはホストにとって扱いやすい間隔として `pollAfterMs` が含まれます。タスクは最初のレスポンスがタイムアウトする前に作成されている必要があるため、長い呼び出しの後にのみ返されるポーリング URL は信頼できる復旧手段ではありません。
530
530
 
531
+ 制限された一時的なステータス取得を利用できない場合、`ask_app_status` は
532
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、元の
533
+ `app` と `taskId`、および `pollAfterMs` / `poll` を返すことがあります。これは
534
+ ステータス取得が利用できないことを意味し、永続タスクが失敗したことを意味しません。
535
+ まったく同じ `app` と `taskId` で `ask_app_status` を再試行してください。送信により
536
+ 作業が重複する可能性があるため、復旧のために `ask_app` を再送信してはいけません。
537
+ 永続的な認証、未検出、プロトコルのエラーは引き続きエラーです。
538
+
531
539
  ### アプリごとのツアー {#tour}
532
540
 
533
541
  ナビゲート可能なリソースを生成またはリストする許可リストに登録されたすべてのテンプレートには `link` ビルダーが同梱されており、取り込みが多いテンプレートには GET + `publicAgent` アクションが同梱されているため、接続されたエージェントはライブ状態を取得できます。
@@ -247,7 +247,27 @@ MCP ツールはノード ランタイムでのみ有効になります — Clou
247
247
  MCP (モデル コンテキスト プロトコル) サーバーは、Zapier、Cloudflare、Composio、または会社の内部ツールへの接続など、エージェントに新しい機能を提供します。接続すると、エージェントはこれらのツールを組み込みツールと同じように使用できるようになります。
248
248
 
249
249
  プリセット ID は `context7`、`sentry`、`notion`、`semgrep`、`linear`、
250
- `atlassian`、`supabase`、`neon`、`stripe` です。
250
+ `atlassian`、`supabase`、`neon`、`stripe`、`cloudflare`、`gitlab`、`figma`、
251
+ `vercel`、`github`、`slack`、`asana`、`hubspot`、`intercom`、`monday`、`webflow`、`paypal`、`box`、`netlify`、`zapier` です。
252
+
253
+ ディレクトリでは、汎用 OAuth フローに対応するエンドポイントと、プロバイダー
254
+ が承認したクライアントまたは事前登録済みの OAuth アプリを必要とするプロバイダーを
255
+ 区別します。後者も発見用に表示され公式のセットアップ手順へリンクしますが、対応して
256
+ いない場合に誤解を招くワンクリック接続ボタンは表示しません。サンドボックス化された
257
+ 拡張機能はホストのアクションを通じて `agentNative.mcp.listTools`、
258
+ `agentNative.mcp.callTool`、`agentNative.providerApi.catalog(...)`、
259
+ `agentNative.providerApi.docs(...)` を使用して接続済みデータを検出でき、接続 URL や
260
+ アクセストークン、リフレッシュトークンを受け取ることはありません。生の
261
+ `provider-api-request` は意図的にホストとエージェントのみに限定されています。任意の
262
+ メソッド/パスのリクエストを共有拡張機能に公開すると、拡張機能が認証済みの書き込み
263
+ プロキシになってしまうためです。拡張機能は代わりに、範囲を限定したプロバイダー操作
264
+ のために `agentNative.mcp.callTool(...)` か、専用に用意されたアプリのアクションを
265
+ 使用する必要があります。
266
+
267
+ ローカルファイル拡張機能は、`extension.json` で `list-mcp-tools`、
268
+ `call-mcp-tool`、および使用するサポート対象のプロバイダーアクションを
269
+ 明示的に許可する必要があります。検出ヘルパーは
270
+ `agentNative.connectors.mcp` と `agentNative.connectors.providerApi` からも利用できます。
251
271
 
252
272
  ### Atlassian / Jira
253
273
 
@@ -231,6 +231,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
231
231
 
232
232
  タスクが最終状態に達するまで、これらの引数を使用して `ask_app_status` を呼び出してください。Dispatch のアプリ所有の `ask_app` は同じ永続的なタスクとステータスの契約を使用し、選択されたアプリの許可は送信時とポーリング時の両方でチェックされます。
233
233
 
234
+ 制限された一時的なステータス取得を利用できない場合、`ask_app_status` は
235
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、元の
236
+ `app` と `taskId`、および `pollAfterMs` / `poll` を返すことがあります。これは
237
+ ステータス取得が利用できないことを意味し、永続タスクが失敗したことを意味しません。
238
+ まったく同じ `app` と `taskId` で `ask_app_status` を再試行してください。送信により
239
+ 作業が重複する可能性があるため、復旧のために `ask_app` を再送信してはいけません。
240
+ 永続的な認証、未検出、プロトコルのエラーは引き続きエラーです。
241
+
234
242
  ## 認証 {#authentication}
235
243
 
236
244
  MCP エンドポイントは、標準のリモート MCP OAuth に加えて、既存のベアラー トークン フォールバックをサポートします。
@@ -536,6 +536,14 @@ MCP 호스트와 게이트웨이는 하나의 긴 도구 호출 제한 시간을
536
536
  전에 작업이 생성되어야 하므로, 오랜 호출이 끝난 후에만 반환되는 폴링 URL은 신뢰할
537
537
  수 있는 복구 계약이 아닙니다.
538
538
 
539
+ 제한된 일시적 상태 읽기를 사용할 수 없으면 `ask_app_status`는
540
+ `status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, 원래의
541
+ `app`과 `taskId`, 그리고 `pollAfterMs` / `poll`을 반환할 수 있습니다. 이는 상태
542
+ 읽기를 사용할 수 없다는 뜻이지 내구성 있는 작업이 실패했다는 뜻은 아닙니다. 정확히 같은
543
+ `app`과 `taskId`로 `ask_app_status`를 재시도하세요. 제출하면 작업이 중복될 수 있으므로
544
+ 복구를 위해 `ask_app`을 다시 제출하지 마세요. 영구적인 인증, 찾을 수 없음, 프로토콜
545
+ 오류는 계속 오류로 남습니다.
546
+
539
547
  ### 앱별 둘러보기 {#tour}
540
548
 
541
549
  탐색 가능한 리소스를 생성하거나 나열하는 모든 허용 목록 템플릿은 `link` 빌더를 제공하고, 수집이 많은 템플릿은 연결된 에이전트가 라이브 상태를 가져올 수 있도록 GET + `publicAgent` 작업을 제공합니다.
@@ -246,7 +246,26 @@ MCP 도구는 노드 런타임(Cloudflare 작업자 및 기타 에지)에서만
246
246
  MCP(모델 컨텍스트 프로토콜) 서버는 에이전트에 Zapier, Cloudflare, Composio 또는 회사 내부 도구에 연결하는 것과 같은 새로운 기능을 제공합니다. 일단 연결되면 에이전트는 내장된 도구와 마찬가지로 해당 도구를 사용할 수 있습니다.
247
247
 
248
248
  프리셋 ID는 `context7`, `sentry`, `notion`, `semgrep`, `linear`,
249
- `atlassian`, `supabase`, `neon`, `stripe`입니다.
249
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
250
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify`, `zapier`입니다.
251
+
252
+ 디렉터리는 일반 OAuth 흐름을 지원하는 엔드포인트와 공급자가 승인한 클라이언트
253
+ 또는 사전 등록된 OAuth 앱이 필요한 공급자를 구분합니다. 후자의 항목도 검색을
254
+ 위해 표시하고 공식 설정 안내로 연결하지만, 지원되지 않는 경우 오해를 부르는
255
+ 원클릭 연결 버튼은 표시하지 않습니다. 샌드박스 확장은 호스트 액션을 통해
256
+ `agentNative.mcp.listTools`, `agentNative.mcp.callTool`,
257
+ `agentNative.providerApi.catalog(...)`, `agentNative.providerApi.docs(...)`를
258
+ 사용해 연결된 데이터를 검색할 수 있으며, 연결 URL이나 액세스 토큰, 리프레시
259
+ 토큰은 절대 받지 않습니다. 원시 `provider-api-request`는 의도적으로 호스트와
260
+ 에이전트에서만 사용할 수 있습니다. 임의의 메서드/경로 요청을 공유 확장에
261
+ 노출하면 해당 확장이 인증된 쓰기 프록시가 될 수 있기 때문입니다. 확장은
262
+ 대신 범위가 제한된 공급자 작업을 위해 `agentNative.mcp.callTool(...)`이나
263
+ 목적에 맞게 만들어진 앱 액션을 사용해야 합니다.
264
+
265
+ 로컬 파일 확장은 `extension.json`에서 `list-mcp-tools`, `call-mcp-tool` 및
266
+ 사용하는 지원되는 공급자 액션을 명시적으로 허용해야 합니다. 검색 도우미는
267
+ `agentNative.connectors.mcp` 및 `agentNative.connectors.providerApi`에서도
268
+ 사용할 수 있습니다.
250
269
 
251
270
  ### Atlassian / Jira
252
271
 
@@ -238,6 +238,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
238
238
  Dispatch의 앱 소유 `ask_app`은 제출과 폴링 모두에서 선택된 앱의 권한을
239
239
  확인하는, 동일한 내구성 있는 작업 및 상태 계약을 사용합니다.
240
240
 
241
+ 제한된 일시적 상태 읽기를 사용할 수 없으면 `ask_app_status`는
242
+ `status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, 원래의
243
+ `app`과 `taskId`, 그리고 `pollAfterMs` / `poll`을 반환할 수 있습니다. 이는 상태
244
+ 읽기를 사용할 수 없다는 뜻이지 내구성 있는 작업이 실패했다는 뜻은 아닙니다. 정확히 같은
245
+ `app`과 `taskId`로 `ask_app_status`를 재시도하세요. 제출하면 작업이 중복될 수 있으므로
246
+ 복구를 위해 `ask_app`을 다시 제출하지 마세요. 영구적인 인증, 찾을 수 없음, 프로토콜
247
+ 오류는 계속 오류로 남습니다.
248
+
241
249
  ## 인증 {#authentication}
242
250
 
243
251
  MCP 엔드포인트는 표준 원격 MCP OAuth와 기존 베어러 토큰 폴백을 지원합니다.
@@ -539,6 +539,15 @@ amigável para hosts. A tarefa precisa ser criada antes que a primeira
539
539
  resposta possa expirar, então um URL de consulta retornado apenas após uma
540
540
  chamada longa não é um contrato de recuperação confiável.
541
541
 
542
+ Se uma leitura de status transitória e limitada estiver indisponível,
543
+ `ask_app_status` poderá retornar `status: "unknown"`,
544
+ `statusRead: "unavailable"`, `retryable: true`, o `app` e o `taskId` originais,
545
+ e `pollAfterMs` / `poll`. Isso significa que a leitura de status está
546
+ indisponível, não que a tarefa durável falhou. Tente novamente `ask_app_status`
547
+ com exatamente o mesmo `app` e `taskId`; nunca reenvie `ask_app` para recuperar,
548
+ pois o envio pode duplicar o trabalho. Erros permanentes de autenticação, de não
549
+ encontrado e de protocolo continuam sendo erros.
550
+
542
551
  ### Tour por aplicativo {#tour}
543
552
 
544
553
  Cada modelo listado como permitido que produz ou lista um recurso navegável envia um construtor `link`, e os modelos pesados enviam uma ação GET + `publicAgent` para que um agente conectado possa extrair o estado ativo:
@@ -246,7 +246,28 @@ Isso significa que os usuários que instalaram a extensão claude-in-chrome ter
246
246
  Os servidores MCP (Model Context Protocol) oferecem novas habilidades ao seu agente, como conectar-se ao Zapier, Cloudflare, Composio ou às ferramentas internas da sua empresa. Uma vez conectado, o agente pode usar essas ferramentas exatamente como as integradas.
247
247
 
248
248
  Os IDs de preset são `context7`, `sentry`, `notion`, `semgrep`, `linear`,
249
- `atlassian`, `supabase`, `neon` e `stripe`.
249
+ `atlassian`, `supabase`, `neon`, `stripe`, `cloudflare`, `gitlab`, `figma`,
250
+ `vercel`, `github`, `slack`, `asana`, `hubspot`, `intercom`, `monday`, `webflow`, `paypal`, `box`, `netlify` e `zapier`.
251
+
252
+ O diretório diferencia endpoints que aceitam o fluxo OAuth genérico de provedores
253
+ que exigem um cliente aprovado pelo provedor ou um aplicativo OAuth pré-registrado.
254
+ Essas entradas continuam visíveis para descoberta e apontam para as instruções
255
+ oficiais, mas não exibem um botão enganoso de conexão com um clique. Extensões
256
+ isoladas usam `agentNative.mcp.listTools`, `agentNative.mcp.callTool` e
257
+ `agentNative.providerApi.catalog(...)`/`agentNative.providerApi.docs(...)` por
258
+ meio das ações do host para descobrir dados conectados; elas nunca recebem
259
+ URLs de conexão, tokens de acesso nem tokens de atualização. A chamada bruta
260
+ `provider-api-request` é intencionalmente restrita ao host e ao agente: expor
261
+ requisições arbitrárias de método/caminho a extensões compartilhadas
262
+ transformaria uma extensão em um proxy de escrita autenticado. Em vez disso,
263
+ as extensões devem usar `agentNative.mcp.callTool(...)` ou uma ação de
264
+ aplicativo criada especificamente para operações de provedor com escopo
265
+ limitado.
266
+
267
+ Extensões de arquivo local devem permitir explicitamente `list-mcp-tools`,
268
+ `call-mcp-tool` e qualquer ação de provedor compatível que usem em
269
+ `extension.json`. Os helpers de descoberta também estão disponíveis em
270
+ `agentNative.connectors.mcp` e `agentNative.connectors.providerApi`.
250
271
 
251
272
  ### Atlassian / Jira
252
273
 
@@ -234,6 +234,15 @@ terminal. O `ask_app` de propriedade do aplicativo no Dispatch usa o mesmo
234
234
  contrato de tarefa durável e status, com a concessão do aplicativo selecionado
235
235
  verificada tanto no envio quanto na consulta.
236
236
 
237
+ Se uma leitura de status transitória e limitada estiver indisponível,
238
+ `ask_app_status` poderá retornar `status: "unknown"`,
239
+ `statusRead: "unavailable"`, `retryable: true`, o `app` e o `taskId` originais,
240
+ e `pollAfterMs` / `poll`. Isso significa que a leitura de status está
241
+ indisponível, não que a tarefa durável falhou. Tente novamente `ask_app_status`
242
+ com exatamente o mesmo `app` e `taskId`; nunca reenvie `ask_app` para recuperar,
243
+ pois o envio pode duplicar o trabalho. Erros permanentes de autenticação, de não
244
+ encontrado e de protocolo continuam sendo erros.
245
+
237
246
  ## Autenticação {#authentication}
238
247
 
239
248
  O endpoint MCP suporta MCP remoto padrão OAuth mais o substituto de token de portador existente:
@@ -525,6 +525,12 @@ CSP 和沙箱权限等安全元数据存在于资源中
525
525
 
526
526
  MCP 主机和网关并不共享同一个较长的工具调用超时时间;有些强制执行五分钟的上限,有些则可配置。不要围绕一个阻塞十分钟的 `tools/call` 来设计外部代理集成。`ask-agent` 和 `ask_app` 会快速确认托管工作已开始,然后在内联等待到期时返回一个持久的 `taskId`。使用返回的 `app` 和 `taskId` 通过 `ask_app_status` 进行轮询;结果中包含 `pollAfterMs`,作为对主机友好的轮询间隔。任务必须在第一次响应超时之前就已创建,因此仅在长时间调用之后才返回的轮询 URL 并不是可靠的恢复约定。
527
527
 
528
+ 当有界的暂态状态读取不可用时,`ask_app_status` 可以返回
529
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
530
+ `app` 和 `taskId`,以及 `pollAfterMs` / `poll`。这表示状态读取不可用,并不表示
531
+ 持久任务失败。请使用完全相同的 `app` 和 `taskId` 重试 `ask_app_status`;切勿为恢复而
532
+ 重新提交 `ask_app`,因为提交可能会重复工作。永久性的身份验证、未找到和协议错误仍然是错误。
533
+
528
534
  ### 每应用游览 {#tour}
529
535
 
530
536
  每个生成或列出可导航资源的允许列表模板都会附带一个 `link` 构建器,而摄取量大的模板会附带一个 GET + `publicAgent` 操作,以便连接的代理可以提取实时状态:
@@ -246,7 +246,23 @@ MCP 工具仅在 Node 运行时激活 - Cloudflare Workers 和其他边缘
246
246
  MCP(模型上下文协议)服务器为您的代理提供新的能力 - 例如连接到 Zapier、Cloudflare、Composio 或您公司的内部工具。连接后,代理可以像使用内置工具一样使用这些工具。
247
247
 
248
248
  预设 ID 包括 `context7`、`sentry`、`notion`、`semgrep`、`linear`、
249
- `atlassian`、`supabase`、`neon` 和 `stripe`。
249
+ `atlassian`、`supabase`、`neon`、`stripe`、`cloudflare`、`gitlab`、`figma`、
250
+ `vercel`、`github`、`slack`、`asana`、`hubspot`、`intercom`、`monday`、`webflow`、`paypal`、`box`、`netlify` 和 `zapier`。
251
+
252
+ 目录会区分支持通用 OAuth 流程的端点,以及需要供应商批准的客户端或预先注册的
253
+ OAuth 应用的供应商。后者仍会显示以便发现,并链接到官方设置说明;但在不支持时,
254
+ 不会显示容易误导的一键连接按钮。沙盒扩展可以通过主机操作使用
255
+ `agentNative.mcp.listTools`、`agentNative.mcp.callTool` 以及
256
+ `agentNative.providerApi.catalog(...)`、`agentNative.providerApi.docs(...)`
257
+ 来发现已连接的数据,但绝不会收到连接 URL、访问令牌或刷新令牌。原始的
258
+ `provider-api-request` 有意仅限主机和代理使用:如果向共享扩展开放任意方法/
259
+ 路径的请求,扩展就可能变成一个经过身份验证的写入代理。因此扩展应改用
260
+ `agentNative.mcp.callTool(...)` 或专门构建的应用操作来执行范围受限的供应商
261
+ 操作。
262
+
263
+ 本地文件扩展必须在 `extension.json` 中明确允许 `list-mcp-tools`、
264
+ `call-mcp-tool` 以及它们使用的任何受支持的提供商操作。发现辅助函数也可通过
265
+ `agentNative.connectors.mcp` 和 `agentNative.connectors.providerApi` 使用。
250
266
 
251
267
  ### Atlassian / Jira
252
268
 
@@ -231,6 +231,12 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
231
231
 
232
232
  使用这些参数调用 `ask_app_status` 进行轮询,直到任务达到终态。Dispatch 中应用自持的 `ask_app` 使用相同的持久任务和状态约定,在提交和轮询时都会检查所选应用的授权。
233
233
 
234
+ 当有界的暂态状态读取不可用时,`ask_app_status` 可以返回
235
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
236
+ `app` 和 `taskId`,以及 `pollAfterMs` / `poll`。这表示状态读取不可用,并不表示
237
+ 持久任务失败。请使用完全相同的 `app` 和 `taskId` 重试 `ask_app_status`;切勿为恢复而
238
+ 重新提交 `ask_app`,因为提交可能会重复工作。永久性的身份验证、未找到和协议错误仍然是错误。
239
+
234
240
  ## 身份验证 {#authentication}
235
241
 
236
242
  MCP 端点支持标准远程 MCP OAuth 以及现有的不记名令牌后备:
@@ -525,6 +525,12 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
525
525
 
526
526
  MCP 主機與閘道器並未共用單一的長工具呼叫逾時限制;有些強制五分鐘上限,有些則可設定。請勿將外部代理整合設計成依賴十分鐘的封鎖式 `tools/call`。`ask-agent` 與 `ask_app` 會快速確認託管工作,並在行內等待逾期時傳回持久的 `taskId`。請使用傳回的 `app` 與 `taskId` 呼叫 `ask_app_status` 進行輪詢;結果包含 `pollAfterMs` 作為對主機友善的輪詢間隔。任務必須在第一次回應逾時之前就已建立,因此僅在長時間呼叫後才傳回輪詢網址並非可靠的復原機制。
527
527
 
528
+ 若有界的暫時狀態讀取無法使用,`ask_app_status` 可傳回
529
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
530
+ `app` 與 `taskId`,以及 `pollAfterMs` / `poll`。這表示狀態讀取無法使用,並不表示
531
+ 持久任務失敗。請以完全相同的 `app` 與 `taskId` 重試 `ask_app_status`;切勿為了復原而
532
+ 重新提交 `ask_app`,因為提交可能重複工作。永久性的驗證、找不到與通訊協定錯誤仍然是錯誤。
533
+
528
534
  ### 每應用游覽 {#tour}
529
535
 
530
536
  每個生成或列出可導覽資源的允許清單範本都會附帶一個 `link` 建置器,而攝取量大的範本會附帶一個 GET + `publicAgent` 操作,以便連線的代理可以擷取即時狀態:
@@ -246,7 +246,23 @@ MCP 工具僅在 Node 執行時啟用 - Cloudflare Workers 和其他邊緣
246
246
  MCP(模型脈絡協議)伺服器為您的代理提供新的能力 - 例如連線到 Zapier、Cloudflare、Composio 或您公司的內部工具。連線後,代理可以像使用內建工具一樣使用這些工具。
247
247
 
248
248
  預設 ID 包括 `context7`、`sentry`、`notion`、`semgrep`、`linear`、
249
- `atlassian`、`supabase`、`neon` 和 `stripe`。
249
+ `atlassian`、`supabase`、`neon`、`stripe`、`cloudflare`、`gitlab`、`figma`、
250
+ `vercel`、`github`、`slack`、`asana`、`hubspot`、`intercom`、`monday`、`webflow`、`paypal`、`box`、`netlify` 和 `zapier`。
251
+
252
+ 目錄會區分支援通用 OAuth 流程的端點,以及需要供應商核准的用戶端或預先註冊的
253
+ OAuth 應用程式的供應商。後者仍會顯示以便探索,並連結至官方設定說明;但在不支援
254
+ 時不會顯示容易誤導的一鍵連線按鈕。沙盒擴充功能可以透過主機動作使用
255
+ `agentNative.mcp.listTools`、`agentNative.mcp.callTool` 以及
256
+ `agentNative.providerApi.catalog(...)`、`agentNative.providerApi.docs(...)`
257
+ 來探索已連線的資料,但絕不會收到連線 URL、存取權杖或重新整理權杖。原始的
258
+ `provider-api-request` 刻意僅限主機與代理使用:若向共用擴充功能開放任意
259
+ 方法/路徑的請求,擴充功能就可能變成一個經過驗證的寫入代理。因此擴充功能
260
+ 應改用 `agentNative.mcp.callTool(...)` 或專為此目的打造的應用程式動作,
261
+ 執行範圍受限的供應商操作。
262
+
263
+ 本機檔案擴充功能必須在 `extension.json` 中明確允許 `list-mcp-tools`、
264
+ `call-mcp-tool` 以及其使用的任何支援供應商動作。探索輔助函式也可透過
265
+ `agentNative.connectors.mcp` 和 `agentNative.connectors.providerApi` 使用。
250
266
 
251
267
  ### Atlassian / Jira
252
268
 
@@ -232,6 +232,12 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
232
232
  請使用這些引數呼叫 `ask_app_status`,直到任務進入終止狀態。Dispatch 應用程式自有的
233
233
  `ask_app` 使用相同的持久任務與狀態合約,並在提交與輪詢時都會檢查所選應用程式的授權。
234
234
 
235
+ 若有界的暫時狀態讀取無法使用,`ask_app_status` 可傳回
236
+ `status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
237
+ `app` 與 `taskId`,以及 `pollAfterMs` / `poll`。這表示狀態讀取無法使用,並不表示
238
+ 持久任務失敗。請以完全相同的 `app` 與 `taskId` 重試 `ask_app_status`;切勿為了復原而
239
+ 重新提交 `ask_app`,因為提交可能重複工作。永久性的驗證、找不到與通訊協定錯誤仍然是錯誤。
240
+
235
241
  ## 驗證 {#authentication}
236
242
 
237
243
  MCP 端點支援標準遠端 MCP OAuth 以及現有的不記名權杖後備: