@agent-native/core 0.98.17 → 0.99.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.
- package/corpus/README.md +2 -2
- package/corpus/core/CHANGELOG.md +25 -0
- package/corpus/core/docs/content/actions.mdx +1 -1
- package/corpus/core/docs/content/authentication.mdx +1 -1
- package/corpus/core/docs/content/dispatch.mdx +3 -3
- package/corpus/core/docs/content/external-agents.mdx +30 -19
- package/corpus/core/docs/content/locales/ar-SA/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/ar-SA/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/ar-SA/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/ar-SA/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/ar-SA/mcp-clients.mdx +31 -3
- package/corpus/core/docs/content/locales/ar-SA/mcp-protocol.mdx +29 -15
- package/corpus/core/docs/content/locales/ar-SA/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/ar-SA/server.mdx +2 -2
- package/corpus/core/docs/content/locales/ar-SA/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/ar-SA/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/ar-SA/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/ar-SA/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/de-DE/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/de-DE/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/de-DE/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/de-DE/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/de-DE/mcp-clients.mdx +37 -3
- package/corpus/core/docs/content/locales/de-DE/mcp-protocol.mdx +29 -15
- package/corpus/core/docs/content/locales/de-DE/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/de-DE/server.mdx +2 -2
- package/corpus/core/docs/content/locales/de-DE/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/de-DE/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/de-DE/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/de-DE/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/es-ES/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/es-ES/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/es-ES/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/es-ES/external-agents.mdx +32 -19
- package/corpus/core/docs/content/locales/es-ES/mcp-clients.mdx +17 -3
- package/corpus/core/docs/content/locales/es-ES/mcp-protocol.mdx +38 -15
- package/corpus/core/docs/content/locales/es-ES/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/es-ES/server.mdx +2 -2
- package/corpus/core/docs/content/locales/es-ES/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/es-ES/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/es-ES/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/es-ES/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/fr-FR/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/fr-FR/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/fr-FR/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/fr-FR/mcp-clients.mdx +17 -3
- package/corpus/core/docs/content/locales/fr-FR/mcp-protocol.mdx +29 -15
- package/corpus/core/docs/content/locales/fr-FR/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/fr-FR/server.mdx +2 -2
- package/corpus/core/docs/content/locales/fr-FR/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/fr-FR/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/fr-FR/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/fr-FR/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/hi-IN/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/hi-IN/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/hi-IN/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/hi-IN/external-agents.mdx +31 -19
- package/corpus/core/docs/content/locales/hi-IN/mcp-clients.mdx +17 -3
- package/corpus/core/docs/content/locales/hi-IN/mcp-protocol.mdx +36 -15
- package/corpus/core/docs/content/locales/hi-IN/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/hi-IN/server.mdx +2 -2
- package/corpus/core/docs/content/locales/hi-IN/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/hi-IN/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/hi-IN/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/hi-IN/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/ja-JP/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/ja-JP/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/ja-JP/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/ja-JP/mcp-clients.mdx +34 -3
- package/corpus/core/docs/content/locales/ja-JP/mcp-protocol.mdx +29 -15
- package/corpus/core/docs/content/locales/ja-JP/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/ja-JP/server.mdx +2 -2
- package/corpus/core/docs/content/locales/ja-JP/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/ja-JP/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/ja-JP/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/ja-JP/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/ko-KR/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/ko-KR/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/ko-KR/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx +30 -19
- package/corpus/core/docs/content/locales/ko-KR/mcp-clients.mdx +33 -3
- package/corpus/core/docs/content/locales/ko-KR/mcp-protocol.mdx +36 -15
- package/corpus/core/docs/content/locales/ko-KR/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/ko-KR/server.mdx +2 -2
- package/corpus/core/docs/content/locales/ko-KR/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/ko-KR/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/ko-KR/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/ko-KR/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/pt-BR/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/pt-BR/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/pt-BR/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx +32 -19
- package/corpus/core/docs/content/locales/pt-BR/mcp-clients.mdx +34 -3
- package/corpus/core/docs/content/locales/pt-BR/mcp-protocol.mdx +32 -15
- package/corpus/core/docs/content/locales/pt-BR/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/pt-BR/server.mdx +2 -2
- package/corpus/core/docs/content/locales/pt-BR/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/pt-BR/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/pt-BR/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-CN/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-CN/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-CN/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-CN/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/zh-CN/mcp-clients.mdx +28 -3
- package/corpus/core/docs/content/locales/zh-CN/mcp-protocol.mdx +29 -15
- package/corpus/core/docs/content/locales/zh-CN/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-CN/server.mdx +2 -2
- package/corpus/core/docs/content/locales/zh-CN/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-CN/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-CN/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/zh-CN/template-plan.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-TW/actions.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-TW/authentication.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-TW/dispatch.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-TW/external-agents.mdx +23 -19
- package/corpus/core/docs/content/locales/zh-TW/mcp-clients.mdx +28 -3
- package/corpus/core/docs/content/locales/zh-TW/mcp-protocol.mdx +30 -15
- package/corpus/core/docs/content/locales/zh-TW/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/locales/zh-TW/server.mdx +2 -2
- package/corpus/core/docs/content/locales/zh-TW/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-TW/template-assets.mdx +1 -1
- package/corpus/core/docs/content/locales/zh-TW/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/locales/zh-TW/template-plan.mdx +3 -3
- package/corpus/core/docs/content/mcp-clients.mdx +31 -4
- package/corpus/core/docs/content/mcp-protocol.mdx +35 -15
- package/corpus/core/docs/content/plan-plugin.mdx +3 -3
- package/corpus/core/docs/content/server.mdx +2 -2
- package/corpus/core/docs/content/skills-guide.mdx +1 -1
- package/corpus/core/docs/content/template-assets.mdx +1 -1
- package/corpus/core/docs/content/template-dispatch.mdx +2 -2
- package/corpus/core/docs/content/template-plan.mdx +3 -3
- package/corpus/core/package.json +1 -1
- package/corpus/core/src/a2a/client.ts +3 -0
- package/corpus/core/src/a2a/handlers.ts +95 -7
- package/corpus/core/src/agent/production-agent.ts +21 -0
- package/corpus/core/src/cli/connect.ts +50 -24
- package/corpus/core/src/cli/mcp-config-writers.ts +10 -0
- package/corpus/core/src/cli/mcp.ts +5 -5
- package/corpus/core/src/cli/pr-visual-recap-workflow.ts +1 -1
- package/corpus/core/src/cli/skills-content/assets-skill.ts +1 -1
- package/corpus/core/src/cli/skills-content/design-exploration-skill.ts +1 -1
- package/corpus/core/src/cli/skills-content/help.ts +1 -1
- package/corpus/core/src/cli/skills-content/plan-setup-auth.ts +1 -1
- package/corpus/core/src/cli/skills-content/visual-plan-skill.ts +1 -1
- package/corpus/core/src/cli/skills-content/visual-recap-skill.ts +2 -2
- package/corpus/core/src/cli/skills.ts +23 -12
- package/corpus/core/src/client/analytics.ts +13 -0
- package/corpus/core/src/client/resources/McpIntegrationDialog.tsx +5 -0
- package/corpus/core/src/client/resources/mcp-integration-catalog.ts +17 -0
- package/corpus/core/src/embedding/agent.ts +8 -6
- package/corpus/core/src/localization/default-messages.ts +7 -0
- package/corpus/core/src/mcp/ask-app-inline-tasks.ts +125 -0
- package/corpus/core/src/mcp/build-server.ts +65 -3
- package/corpus/core/src/mcp/builtin-tools.ts +186 -22
- package/corpus/core/src/mcp/connect-route.ts +17 -14
- package/corpus/core/src/mcp/oauth-route.ts +38 -13
- package/corpus/core/src/mcp/route-paths.ts +34 -0
- package/corpus/core/src/mcp/server.ts +21 -10
- package/corpus/core/src/mcp/stdio.ts +34 -16
- package/corpus/core/src/mcp/workspace-resolve.ts +2 -1
- package/corpus/core/src/mcp-client/manager.ts +5 -3
- package/corpus/core/src/mcp-client/remote-store.ts +10 -10
- package/corpus/core/src/server/agent-chat/action-filters-a2a.ts +13 -0
- package/corpus/core/src/server/agent-chat-plugin.ts +42 -9
- package/corpus/core/src/server/agent-teams.ts +17 -0
- package/corpus/core/src/server/auth.ts +22 -6
- package/corpus/core/src/server/core-routes-plugin.ts +30 -24
- package/corpus/core/src/server/csrf.ts +17 -0
- package/corpus/core/src/server/framework-request-handler.ts +8 -2
- package/corpus/core/src/server/google-oauth.ts +12 -2
- package/corpus/core/src/server/http-response-telemetry.ts +6 -1
- package/corpus/core/src/server/recap-image-route.ts +3 -3
- package/corpus/core/src/server/security-headers.ts +7 -1
- package/corpus/core/src/server/ssr-handler.ts +2 -0
- package/corpus/core/src/shared/cache-control.ts +6 -4
- package/corpus/core/src/templates/default/.agents/skills/security/SKILL.md +10 -0
- package/corpus/core/src/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
- package/corpus/core/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
- package/corpus/core/src/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
- package/corpus/core/src/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/analytics/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/analytics/app/assets/replay-cursor.svg +17 -0
- package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx +4 -3
- package/corpus/templates/analytics/app/global.css +71 -4
- package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/DashboardFilterBar.tsx +32 -4
- package/corpus/templates/analytics/app/pages/monitoring/errors/IssueDetail.tsx +1 -1
- package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx +49 -11
- package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx +4 -6
- package/corpus/templates/analytics/changelog/2026-07-13-all-time-dashboard-filters-no-longer-send-invalid-dates-to-b.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-daily-dashboard-emails-recover-more-reliably-from-serverless.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-error-issue-titles-wrap-instead-of-overflowing.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-saving-a-new-dashboard-view-no-longer-fails-with-a-server-er.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-session-replay-cursors-stay-hidden-until-their-first-recorde.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-session-replay-links-now-support-cmd-click-and-middle-click-.md +6 -0
- package/corpus/templates/analytics/changelog/2026-07-13-session-replays-keep-a-visible-mac-style-cursor-over-the-vis.md +6 -0
- package/corpus/templates/analytics/server/jobs/dashboard-report.ts +21 -2
- package/corpus/templates/analytics/server/lib/dashboard-report-subscriptions.ts +57 -1
- package/corpus/templates/analytics/server/lib/dashboard-report.ts +266 -28
- package/corpus/templates/analytics/server/lib/dashboards-store.ts +43 -4
- package/corpus/templates/analytics/server/lib/error-capture.ts +24 -5
- package/corpus/templates/analytics/server/plugins/agent-chat.ts +5 -0
- package/corpus/templates/analytics/server/routes/[...page].get.ts +0 -2
- package/corpus/templates/assets/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/assets/agent-native.app-skill.json +1 -1
- package/corpus/templates/brain/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/calendar/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/calendar/AGENTS.md +2 -1
- package/corpus/templates/calendar/app/components/calendar/EventDetailPopover.tsx +0 -19
- package/corpus/templates/calendar/app/lib/attendee-local-time.ts +14 -5
- package/corpus/templates/calendar/changelog/2026-07-13-your-local-time-now-follows-your-browser-timezone-and-event-.md +6 -0
- package/corpus/templates/chat/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/clips/.agents/skills/recording/SKILL.md +7 -2
- package/corpus/templates/clips/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/clips/AGENTS.md +7 -0
- package/corpus/templates/clips/actions/list-meetings.ts +19 -4
- package/corpus/templates/clips/actions/start-meeting-recording.ts +7 -1
- package/corpus/templates/clips/app/components/library/recording-card.tsx +27 -26
- package/corpus/templates/clips/app/components/library/space-card.tsx +4 -6
- package/corpus/templates/clips/app/components/meetings/transcript-bubbles.tsx +75 -78
- package/corpus/templates/clips/app/components/recorder/confetti-canvas.tsx +18 -1
- package/corpus/templates/clips/app/components/recorder/recorder-engine.ts +6 -12
- package/corpus/templates/clips/app/components/recorder/recording-toolbar.tsx +19 -2
- package/corpus/templates/clips/app/lib/camera-composite.ts +70 -10
- package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx +1 -1
- package/corpus/templates/clips/app/routes/record.tsx +5 -25
- package/corpus/templates/clips/changelog/2026-07-13-clips-desktop-now-requires-macos-13-for-native-capture.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-clips-hide-solo-meeting-reminders.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-clips-now-removes-duplicate-mic-and-system-transcript-turns-.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-desktop-recordings-run-cooler-and-quieter-live-transcription.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-meeting-recordings-now-stop-after-a-calendar-meeting-ends-an.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-meeting-transcripts-now-use-a-clean-agent-chat-style-reading.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-13-screen-recordings-use-less-processing-power-during-longer-ca.md +6 -0
- package/corpus/templates/clips/chrome-extension/src/background.ts +5 -3
- package/corpus/templates/clips/chrome-extension/src/offscreen.ts +17 -14
- package/corpus/templates/clips/chrome-extension/src/overlay.ts +8 -2
- package/corpus/templates/clips/desktop/README.md +3 -0
- package/corpus/templates/clips/desktop/src/hooks/useMeetingTranscription.ts +9 -0
- package/corpus/templates/clips/desktop/src/lib/recorder.ts +8 -2
- package/corpus/templates/clips/desktop/src/lib/silence-events.ts +1 -0
- package/corpus/templates/clips/desktop/src/lib/transcription-capture.ts +5 -0
- package/corpus/templates/clips/desktop/src/lib/transcription-engine.ts +134 -5
- package/corpus/templates/clips/desktop/src/lib/upload-video-stream.ts +28 -0
- package/corpus/templates/clips/desktop/src/overlays/flow-bar.tsx +10 -3
- package/corpus/templates/clips/desktop/src/overlays/meeting-notification.tsx +42 -9
- package/corpus/templates/clips/desktop/src/overlays/recording-pill.tsx +10 -2
- package/corpus/templates/clips/desktop/src-tauri/Cargo.toml +6 -1
- package/corpus/templates/clips/desktop/src-tauri/src/notifications.rs +77 -1
- package/corpus/templates/clips/desktop/src-tauri/src/silence_detector.rs +104 -25
- package/corpus/templates/clips/desktop/src-tauri/src/system_audio.rs +4 -0
- package/corpus/templates/clips/desktop/src-tauri/src/whisper_speech.rs +287 -32
- package/corpus/templates/clips/desktop/src-tauri/tauri.conf.json +1 -1
- package/corpus/templates/clips/server/lib/calendar-event-classification.ts +28 -0
- package/corpus/templates/clips/server/routes/[...page].get.ts +1 -59
- package/corpus/templates/clips/shared/recording-capture.ts +37 -0
- package/corpus/templates/content/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/content/agent-native.app-skill.json +1 -1
- package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +18 -16
- package/corpus/templates/content/server/routes/[...page].get.ts +1 -15
- package/corpus/templates/design/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/design/actions/connect-assets-mcp.ts +1 -1
- package/corpus/templates/design/agent-native.app-skill.json +1 -1
- package/corpus/templates/design/app/components/design/DesignCanvas.tsx +88 -12
- package/corpus/templates/design/app/components/design/MultiScreenCanvas.tsx +1 -0
- package/corpus/templates/design/app/components/design/bridge/editor-chrome.bridge.ts +4 -1
- package/corpus/templates/design/changelog/2026-07-13-adding-shapes-preserves-canvas-background.md +6 -0
- package/corpus/templates/design/changelog/2026-07-13-clicking-quickly-between-overlapping-elements-no-longer-bounc.md +6 -0
- package/corpus/templates/design/server/plugins/assets-mcp.ts +1 -1
- package/corpus/templates/design/server/routes/[...page].get.ts +0 -2
- package/corpus/templates/dispatch/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/forms/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/macros/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/mail/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/plan/.agents/skills/security/SKILL.md +10 -0
- package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +1 -1
- package/corpus/templates/plan/.agents/skills/visual-recap/SKILL.md +2 -2
- package/corpus/templates/plan/agent-native.app-skill.json +1 -1
- package/corpus/templates/plan/app/lib/plan-local-bridge.ts +6 -1
- package/corpus/templates/plan/app/pages/PlansPage.tsx +15 -6
- package/corpus/templates/plan/changelog/2026-07-13-fixed-local-plan-previews-continuously-flickering-while-revi.md +6 -0
- package/corpus/templates/plan/server/routes/[...page].get.ts +0 -2
- package/corpus/templates/slides/.agents/skills/security/SKILL.md +10 -0
- package/dist/a2a/client.d.ts +2 -0
- package/dist/a2a/client.d.ts.map +1 -1
- package/dist/a2a/client.js +2 -0
- package/dist/a2a/client.js.map +1 -1
- package/dist/a2a/handlers.d.ts.map +1 -1
- package/dist/a2a/handlers.js +84 -7
- package/dist/a2a/handlers.js.map +1 -1
- package/dist/agent/production-agent.d.ts +9 -0
- package/dist/agent/production-agent.d.ts.map +1 -1
- package/dist/agent/production-agent.js +12 -0
- package/dist/agent/production-agent.js.map +1 -1
- package/dist/cli/connect.d.ts +2 -2
- package/dist/cli/connect.d.ts.map +1 -1
- package/dist/cli/connect.js +45 -23
- package/dist/cli/connect.js.map +1 -1
- package/dist/cli/mcp-config-writers.d.ts.map +1 -1
- package/dist/cli/mcp-config-writers.js +7 -0
- package/dist/cli/mcp-config-writers.js.map +1 -1
- package/dist/cli/mcp.js +5 -3
- package/dist/cli/mcp.js.map +1 -1
- package/dist/cli/pr-visual-recap-workflow.d.ts +1 -1
- package/dist/cli/pr-visual-recap-workflow.d.ts.map +1 -1
- package/dist/cli/pr-visual-recap-workflow.js +1 -1
- package/dist/cli/pr-visual-recap-workflow.js.map +1 -1
- package/dist/cli/skills-content/assets-skill.d.ts +1 -1
- package/dist/cli/skills-content/assets-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/assets-skill.js +1 -1
- package/dist/cli/skills-content/assets-skill.js.map +1 -1
- package/dist/cli/skills-content/design-exploration-skill.d.ts +1 -1
- package/dist/cli/skills-content/design-exploration-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/design-exploration-skill.js +1 -1
- package/dist/cli/skills-content/design-exploration-skill.js.map +1 -1
- package/dist/cli/skills-content/help.d.ts +1 -1
- package/dist/cli/skills-content/help.d.ts.map +1 -1
- package/dist/cli/skills-content/help.js +1 -1
- package/dist/cli/skills-content/help.js.map +1 -1
- package/dist/cli/skills-content/plan-setup-auth.d.ts +1 -1
- package/dist/cli/skills-content/plan-setup-auth.d.ts.map +1 -1
- package/dist/cli/skills-content/plan-setup-auth.js +1 -1
- package/dist/cli/skills-content/plan-setup-auth.js.map +1 -1
- package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
- package/dist/cli/skills-content/visual-plan-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/visual-plan-skill.js +1 -1
- package/dist/cli/skills-content/visual-plan-skill.js.map +1 -1
- package/dist/cli/skills-content/visual-recap-skill.d.ts +1 -1
- package/dist/cli/skills-content/visual-recap-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/visual-recap-skill.js +2 -2
- package/dist/cli/skills-content/visual-recap-skill.js.map +1 -1
- package/dist/cli/skills.d.ts.map +1 -1
- package/dist/cli/skills.js +16 -12
- package/dist/cli/skills.js.map +1 -1
- package/dist/client/analytics.d.ts.map +1 -1
- package/dist/client/analytics.js +11 -0
- package/dist/client/analytics.js.map +1 -1
- package/dist/client/resources/McpIntegrationDialog.d.ts.map +1 -1
- package/dist/client/resources/McpIntegrationDialog.js +1 -1
- package/dist/client/resources/McpIntegrationDialog.js.map +1 -1
- package/dist/client/resources/mcp-integration-catalog.d.ts +1 -0
- package/dist/client/resources/mcp-integration-catalog.d.ts.map +1 -1
- package/dist/client/resources/mcp-integration-catalog.js +14 -0
- package/dist/client/resources/mcp-integration-catalog.js.map +1 -1
- package/dist/collab/awareness.d.ts +2 -2
- package/dist/collab/awareness.d.ts.map +1 -1
- package/dist/collab/routes.d.ts +1 -1
- package/dist/collab/struct-routes.d.ts +1 -1
- package/dist/embedding/agent.d.ts.map +1 -1
- package/dist/embedding/agent.js +6 -7
- package/dist/embedding/agent.js.map +1 -1
- package/dist/localization/default-messages.d.ts +5 -0
- package/dist/localization/default-messages.d.ts.map +1 -1
- package/dist/localization/default-messages.js +5 -0
- package/dist/localization/default-messages.js.map +1 -1
- package/dist/mcp/ask-app-inline-tasks.d.ts +47 -0
- package/dist/mcp/ask-app-inline-tasks.d.ts.map +1 -0
- package/dist/mcp/ask-app-inline-tasks.js +87 -0
- package/dist/mcp/ask-app-inline-tasks.js.map +1 -0
- package/dist/mcp/build-server.d.ts.map +1 -1
- package/dist/mcp/build-server.js +56 -3
- package/dist/mcp/build-server.js.map +1 -1
- package/dist/mcp/builtin-tools.d.ts.map +1 -1
- package/dist/mcp/builtin-tools.js +141 -21
- package/dist/mcp/builtin-tools.js.map +1 -1
- package/dist/mcp/connect-route.d.ts +12 -10
- package/dist/mcp/connect-route.d.ts.map +1 -1
- package/dist/mcp/connect-route.js +17 -14
- package/dist/mcp/connect-route.js.map +1 -1
- package/dist/mcp/oauth-route.d.ts +1 -1
- package/dist/mcp/oauth-route.d.ts.map +1 -1
- package/dist/mcp/oauth-route.js +30 -13
- package/dist/mcp/oauth-route.js.map +1 -1
- package/dist/mcp/route-paths.d.ts +13 -0
- package/dist/mcp/route-paths.d.ts.map +1 -0
- package/dist/mcp/route-paths.js +27 -0
- package/dist/mcp/route-paths.js.map +1 -0
- package/dist/mcp/server.d.ts +2 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +14 -6
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/stdio.d.ts +7 -6
- package/dist/mcp/stdio.d.ts.map +1 -1
- package/dist/mcp/stdio.js +27 -15
- package/dist/mcp/stdio.js.map +1 -1
- package/dist/mcp/workspace-resolve.d.ts +2 -1
- package/dist/mcp/workspace-resolve.d.ts.map +1 -1
- package/dist/mcp/workspace-resolve.js +2 -1
- package/dist/mcp/workspace-resolve.js.map +1 -1
- package/dist/mcp-client/manager.js +6 -3
- package/dist/mcp-client/manager.js.map +1 -1
- package/dist/mcp-client/remote-store.js +5 -7
- package/dist/mcp-client/remote-store.js.map +1 -1
- package/dist/notifications/routes.d.ts +3 -3
- package/dist/progress/routes.d.ts +1 -1
- package/dist/provider-api/corpus-jobs.d.ts +2 -2
- package/dist/resources/handlers.d.ts +2 -2
- package/dist/server/agent-chat/action-filters-a2a.d.ts.map +1 -1
- package/dist/server/agent-chat/action-filters-a2a.js +11 -1
- package/dist/server/agent-chat/action-filters-a2a.js.map +1 -1
- package/dist/server/agent-chat-plugin.d.ts.map +1 -1
- package/dist/server/agent-chat-plugin.js +43 -11
- package/dist/server/agent-chat-plugin.js.map +1 -1
- package/dist/server/agent-engine-api-key-route.d.ts +1 -1
- package/dist/server/agent-teams.d.ts.map +1 -1
- package/dist/server/agent-teams.js +15 -1
- package/dist/server/agent-teams.js.map +1 -1
- package/dist/server/auth.d.ts.map +1 -1
- package/dist/server/auth.js +16 -6
- package/dist/server/auth.js.map +1 -1
- package/dist/server/core-routes-plugin.d.ts +4 -3
- package/dist/server/core-routes-plugin.d.ts.map +1 -1
- package/dist/server/core-routes-plugin.js +20 -15
- package/dist/server/core-routes-plugin.js.map +1 -1
- package/dist/server/csrf.d.ts.map +1 -1
- package/dist/server/csrf.js +11 -0
- package/dist/server/csrf.js.map +1 -1
- package/dist/server/framework-request-handler.d.ts.map +1 -1
- package/dist/server/framework-request-handler.js +8 -2
- package/dist/server/framework-request-handler.js.map +1 -1
- package/dist/server/google-oauth.d.ts +2 -0
- package/dist/server/google-oauth.d.ts.map +1 -1
- package/dist/server/google-oauth.js +11 -2
- package/dist/server/google-oauth.js.map +1 -1
- package/dist/server/http-response-telemetry.d.ts.map +1 -1
- package/dist/server/http-response-telemetry.js +4 -1
- package/dist/server/http-response-telemetry.js.map +1 -1
- package/dist/server/recap-image-route.js +3 -3
- package/dist/server/recap-image-route.js.map +1 -1
- package/dist/server/security-headers.d.ts.map +1 -1
- package/dist/server/security-headers.js +4 -1
- package/dist/server/security-headers.js.map +1 -1
- package/dist/server/ssr-handler.d.ts.map +1 -1
- package/dist/server/ssr-handler.js +3 -1
- package/dist/server/ssr-handler.js.map +1 -1
- package/dist/shared/cache-control.d.ts +7 -6
- package/dist/shared/cache-control.d.ts.map +1 -1
- package/dist/shared/cache-control.js +4 -3
- package/dist/shared/cache-control.js.map +1 -1
- package/dist/templates/default/.agents/skills/security/SKILL.md +10 -0
- package/dist/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
- package/dist/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
- package/dist/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
- package/dist/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
- package/docs/content/actions.mdx +1 -1
- package/docs/content/authentication.mdx +1 -1
- package/docs/content/dispatch.mdx +3 -3
- package/docs/content/external-agents.mdx +30 -19
- package/docs/content/locales/ar-SA/actions.mdx +1 -1
- package/docs/content/locales/ar-SA/authentication.mdx +1 -1
- package/docs/content/locales/ar-SA/dispatch.mdx +3 -3
- package/docs/content/locales/ar-SA/external-agents.mdx +23 -19
- package/docs/content/locales/ar-SA/mcp-clients.mdx +31 -3
- package/docs/content/locales/ar-SA/mcp-protocol.mdx +29 -15
- package/docs/content/locales/ar-SA/plan-plugin.mdx +3 -3
- package/docs/content/locales/ar-SA/server.mdx +2 -2
- package/docs/content/locales/ar-SA/skills-guide.mdx +1 -1
- package/docs/content/locales/ar-SA/template-assets.mdx +1 -1
- package/docs/content/locales/ar-SA/template-dispatch.mdx +2 -2
- package/docs/content/locales/ar-SA/template-plan.mdx +3 -3
- package/docs/content/locales/de-DE/actions.mdx +1 -1
- package/docs/content/locales/de-DE/authentication.mdx +1 -1
- package/docs/content/locales/de-DE/dispatch.mdx +3 -3
- package/docs/content/locales/de-DE/external-agents.mdx +23 -19
- package/docs/content/locales/de-DE/mcp-clients.mdx +37 -3
- package/docs/content/locales/de-DE/mcp-protocol.mdx +29 -15
- package/docs/content/locales/de-DE/plan-plugin.mdx +3 -3
- package/docs/content/locales/de-DE/server.mdx +2 -2
- package/docs/content/locales/de-DE/skills-guide.mdx +1 -1
- package/docs/content/locales/de-DE/template-assets.mdx +1 -1
- package/docs/content/locales/de-DE/template-dispatch.mdx +2 -2
- package/docs/content/locales/de-DE/template-plan.mdx +3 -3
- package/docs/content/locales/es-ES/actions.mdx +1 -1
- package/docs/content/locales/es-ES/authentication.mdx +1 -1
- package/docs/content/locales/es-ES/dispatch.mdx +3 -3
- package/docs/content/locales/es-ES/external-agents.mdx +32 -19
- package/docs/content/locales/es-ES/mcp-clients.mdx +17 -3
- package/docs/content/locales/es-ES/mcp-protocol.mdx +38 -15
- package/docs/content/locales/es-ES/plan-plugin.mdx +3 -3
- package/docs/content/locales/es-ES/server.mdx +2 -2
- package/docs/content/locales/es-ES/skills-guide.mdx +1 -1
- package/docs/content/locales/es-ES/template-assets.mdx +1 -1
- package/docs/content/locales/es-ES/template-dispatch.mdx +2 -2
- package/docs/content/locales/es-ES/template-plan.mdx +3 -3
- package/docs/content/locales/fr-FR/actions.mdx +1 -1
- package/docs/content/locales/fr-FR/authentication.mdx +1 -1
- package/docs/content/locales/fr-FR/dispatch.mdx +3 -3
- package/docs/content/locales/fr-FR/external-agents.mdx +23 -19
- package/docs/content/locales/fr-FR/mcp-clients.mdx +17 -3
- package/docs/content/locales/fr-FR/mcp-protocol.mdx +29 -15
- package/docs/content/locales/fr-FR/plan-plugin.mdx +3 -3
- package/docs/content/locales/fr-FR/server.mdx +2 -2
- package/docs/content/locales/fr-FR/skills-guide.mdx +1 -1
- package/docs/content/locales/fr-FR/template-assets.mdx +1 -1
- package/docs/content/locales/fr-FR/template-dispatch.mdx +2 -2
- package/docs/content/locales/fr-FR/template-plan.mdx +3 -3
- package/docs/content/locales/hi-IN/actions.mdx +1 -1
- package/docs/content/locales/hi-IN/authentication.mdx +1 -1
- package/docs/content/locales/hi-IN/dispatch.mdx +3 -3
- package/docs/content/locales/hi-IN/external-agents.mdx +31 -19
- package/docs/content/locales/hi-IN/mcp-clients.mdx +17 -3
- package/docs/content/locales/hi-IN/mcp-protocol.mdx +36 -15
- package/docs/content/locales/hi-IN/plan-plugin.mdx +3 -3
- package/docs/content/locales/hi-IN/server.mdx +2 -2
- package/docs/content/locales/hi-IN/skills-guide.mdx +1 -1
- package/docs/content/locales/hi-IN/template-assets.mdx +1 -1
- package/docs/content/locales/hi-IN/template-dispatch.mdx +2 -2
- package/docs/content/locales/hi-IN/template-plan.mdx +3 -3
- package/docs/content/locales/ja-JP/actions.mdx +1 -1
- package/docs/content/locales/ja-JP/authentication.mdx +1 -1
- package/docs/content/locales/ja-JP/dispatch.mdx +3 -3
- package/docs/content/locales/ja-JP/external-agents.mdx +23 -19
- package/docs/content/locales/ja-JP/mcp-clients.mdx +34 -3
- package/docs/content/locales/ja-JP/mcp-protocol.mdx +29 -15
- package/docs/content/locales/ja-JP/plan-plugin.mdx +3 -3
- package/docs/content/locales/ja-JP/server.mdx +2 -2
- package/docs/content/locales/ja-JP/skills-guide.mdx +1 -1
- package/docs/content/locales/ja-JP/template-assets.mdx +1 -1
- package/docs/content/locales/ja-JP/template-dispatch.mdx +2 -2
- package/docs/content/locales/ja-JP/template-plan.mdx +3 -3
- package/docs/content/locales/ko-KR/actions.mdx +1 -1
- package/docs/content/locales/ko-KR/authentication.mdx +1 -1
- package/docs/content/locales/ko-KR/dispatch.mdx +3 -3
- package/docs/content/locales/ko-KR/external-agents.mdx +30 -19
- package/docs/content/locales/ko-KR/mcp-clients.mdx +33 -3
- package/docs/content/locales/ko-KR/mcp-protocol.mdx +36 -15
- package/docs/content/locales/ko-KR/plan-plugin.mdx +3 -3
- package/docs/content/locales/ko-KR/server.mdx +2 -2
- package/docs/content/locales/ko-KR/skills-guide.mdx +1 -1
- package/docs/content/locales/ko-KR/template-assets.mdx +1 -1
- package/docs/content/locales/ko-KR/template-dispatch.mdx +2 -2
- package/docs/content/locales/ko-KR/template-plan.mdx +3 -3
- package/docs/content/locales/pt-BR/actions.mdx +1 -1
- package/docs/content/locales/pt-BR/authentication.mdx +1 -1
- package/docs/content/locales/pt-BR/dispatch.mdx +3 -3
- package/docs/content/locales/pt-BR/external-agents.mdx +32 -19
- package/docs/content/locales/pt-BR/mcp-clients.mdx +34 -3
- package/docs/content/locales/pt-BR/mcp-protocol.mdx +32 -15
- package/docs/content/locales/pt-BR/plan-plugin.mdx +3 -3
- package/docs/content/locales/pt-BR/server.mdx +2 -2
- package/docs/content/locales/pt-BR/skills-guide.mdx +1 -1
- package/docs/content/locales/pt-BR/template-assets.mdx +1 -1
- package/docs/content/locales/pt-BR/template-dispatch.mdx +2 -2
- package/docs/content/locales/pt-BR/template-plan.mdx +3 -3
- package/docs/content/locales/zh-CN/actions.mdx +1 -1
- package/docs/content/locales/zh-CN/authentication.mdx +1 -1
- package/docs/content/locales/zh-CN/dispatch.mdx +3 -3
- package/docs/content/locales/zh-CN/external-agents.mdx +23 -19
- package/docs/content/locales/zh-CN/mcp-clients.mdx +28 -3
- package/docs/content/locales/zh-CN/mcp-protocol.mdx +29 -15
- package/docs/content/locales/zh-CN/plan-plugin.mdx +3 -3
- package/docs/content/locales/zh-CN/server.mdx +2 -2
- package/docs/content/locales/zh-CN/skills-guide.mdx +1 -1
- package/docs/content/locales/zh-CN/template-assets.mdx +1 -1
- package/docs/content/locales/zh-CN/template-dispatch.mdx +2 -2
- package/docs/content/locales/zh-CN/template-plan.mdx +3 -3
- package/docs/content/locales/zh-TW/actions.mdx +1 -1
- package/docs/content/locales/zh-TW/authentication.mdx +1 -1
- package/docs/content/locales/zh-TW/dispatch.mdx +3 -3
- package/docs/content/locales/zh-TW/external-agents.mdx +23 -19
- package/docs/content/locales/zh-TW/mcp-clients.mdx +28 -3
- package/docs/content/locales/zh-TW/mcp-protocol.mdx +30 -15
- package/docs/content/locales/zh-TW/plan-plugin.mdx +3 -3
- package/docs/content/locales/zh-TW/server.mdx +2 -2
- package/docs/content/locales/zh-TW/skills-guide.mdx +1 -1
- package/docs/content/locales/zh-TW/template-assets.mdx +1 -1
- package/docs/content/locales/zh-TW/template-dispatch.mdx +2 -2
- package/docs/content/locales/zh-TW/template-plan.mdx +3 -3
- package/docs/content/mcp-clients.mdx +31 -4
- package/docs/content/mcp-protocol.mdx +35 -15
- package/docs/content/plan-plugin.mdx +3 -3
- package/docs/content/server.mdx +2 -2
- package/docs/content/skills-guide.mdx +1 -1
- package/docs/content/template-assets.mdx +1 -1
- package/docs/content/template-dispatch.mdx +2 -2
- package/docs/content/template-plan.mdx +3 -3
- package/package.json +2 -2
- package/src/templates/default/.agents/skills/security/SKILL.md +10 -0
- package/src/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
- package/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
- package/src/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
- package/src/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
|
@@ -22,7 +22,7 @@ MCP est le protocole standard pour connecter les outils d'IA à des capacités e
|
|
|
22
22
|
|
|
23
23
|
Concepts clés :
|
|
24
24
|
|
|
25
|
-
- **Monté automatiquement** – chaque application obtient `/
|
|
25
|
+
- **Monté automatiquement** – chaque application obtient `/mcp` gratuitement, aucune configuration requise
|
|
26
26
|
- **Streamable HTTP** : utilise le transport moderne MCP par rapport au HTTP standard (POST + SSE)
|
|
27
27
|
- **Même actions** : exactement le même registre d'actions qui alimente le chat des agents et A2A
|
|
28
28
|
- **Outil `ask-agent`** — un méta-outil qui délègue à la boucle d'agent complète les tâches complexes
|
|
@@ -41,7 +41,7 @@ Concepts clés :
|
|
|
41
41
|
</div>
|
|
42
42
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
43
43
|
<div class="diagram-panel">
|
|
44
|
-
<span class="diagram-pill accent">POST /
|
|
44
|
+
<span class="diagram-pill accent">POST /mcp</span
|
|
45
45
|
><small class="diagram-muted">Streamable HTTP</small
|
|
46
46
|
><small class="diagram-muted"
|
|
47
47
|
>initialize → tools/list → tools/call</small
|
|
@@ -94,7 +94,7 @@ Les deux protocoles sont montés automatiquement. Utilisez celui qui correspond
|
|
|
94
94
|
| **Idéal pour** | Outils externes appelant votre application | Communication d'agent à agent |
|
|
95
95
|
| **Protocole** | MCP HTTP diffusable | JSON-RPC 2.0 |
|
|
96
96
|
| **Découverte d'outils** | `tools/list` | Carte d'agent à `/.well-known/agent-card.json` |
|
|
97
|
-
| **Point de terminaison** | `/
|
|
97
|
+
| **Point de terminaison** | `/mcp` | `/_agent-native/a2a` |
|
|
98
98
|
| **Supporté par** | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork et autres hôtes MCP | Autres applications natives pour agents |
|
|
99
99
|
| **Exécution** | Appels d'outils directs (pas de LLM supplémentaire) | Boucle d'agent complète (raisonnement LLM) |
|
|
100
100
|
|
|
@@ -105,7 +105,7 @@ Vous pouvez également utiliser l'outil `ask-agent` MCP pour tirer le meilleur p
|
|
|
105
105
|
Pour la configuration recommandée en une seule commande, utilisez [External Agents](/docs/external-agents). Si vous écrivez manuellement la configuration MCP pour un client compatible OAuth, ajoutez votre application en tant que serveur MCP distant sans en-têtes statiques :
|
|
106
106
|
|
|
107
107
|
```bash
|
|
108
|
-
claude mcp add --transport http mail https://mail.example.com/
|
|
108
|
+
claude mcp add --transport http mail https://mail.example.com/mcp
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
Ou écrivez l'entrée à la main dans `.mcp.json` (portée du projet) ou `~/.claude.json` (portée utilisateur) :
|
|
@@ -116,7 +116,7 @@ Ou écrivez l'entrée à la main dans `.mcp.json` (portée du projet) ou `~/.cla
|
|
|
116
116
|
"mcpServers": {
|
|
117
117
|
"mail": {
|
|
118
118
|
"type": "http",
|
|
119
|
-
"url": "https://mail.example.com/
|
|
119
|
+
"url": "https://mail.example.com/mcp",
|
|
120
120
|
},
|
|
121
121
|
},
|
|
122
122
|
}
|
|
@@ -135,12 +135,12 @@ Claude Code calls: draft-email(to: "john@example.com", subject: "Q3 Report", bod
|
|
|
135
135
|
Tout client MCP prenant en charge le transport Streamable HTTP peut se connecter. Le point final est :
|
|
136
136
|
|
|
137
137
|
```
|
|
138
|
-
POST https://your-app.example.com/
|
|
138
|
+
POST https://your-app.example.com/mcp
|
|
139
139
|
```
|
|
140
140
|
|
|
141
141
|
Le serveur prend en charge la négociation standard MCP : `initialize` → `initialized` → `tools/list` → `tools/call`.
|
|
142
142
|
|
|
143
|
-
<Endpoint id="doc-block-bd4fya" title="Point de terminaison MCP" summary={"Le point de terminaison Streamable HTTP monté automatiquement et exposé par chaque application native d'agent."} method="POST" path="/
|
|
143
|
+
<Endpoint id="doc-block-bd4fya" title="Point de terminaison MCP" summary={"Le point de terminaison Streamable HTTP monté automatiquement et exposé par chaque application native d'agent."} method="POST" path="/mcp" summary="MCP Point de terminaison HTTP diffusable" auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
|
|
144
144
|
{
|
|
145
145
|
"name": "Authorization",
|
|
146
146
|
"in": "header",
|
|
@@ -204,18 +204,32 @@ Lorsque `mcpApp` est présent, l'entrée d'outil inclut également `_meta.ui.res
|
|
|
204
204
|
|
|
205
205
|
En plus des outils d'action individuels, chaque serveur MCP comprend un méta-outil `ask-agent`. Cela envoie un message en langage naturel à l'agent IA de l'application et renvoie la réponse.
|
|
206
206
|
|
|
207
|
+
Les requêtes MCP hébergées utilisent une attente en ligne bornée afin qu'une longue boucle d'agent ne maintienne pas un `tools/call` ouvert jusqu'à l'expiration du délai du client ou de la passerelle. L'argument facultatif `async` démarre la tâche durable et renvoie immédiatement ; sans lui, le serveur attend brièvement une réussite rapide, puis renvoie un descripteur de tâche lorsqu'il reste du travail à faire. L'attente hébergée est plafonnée à 25 secondes.
|
|
208
|
+
|
|
207
209
|
Utilisez `ask-agent` pour des tâches complexes qui bénéficient du raisonnement et du contexte de l'agent :
|
|
208
210
|
|
|
209
211
|
```json
|
|
210
212
|
{
|
|
211
213
|
"name": "ask-agent",
|
|
212
214
|
"arguments": {
|
|
213
|
-
"message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed"
|
|
215
|
+
"message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed",
|
|
216
|
+
"async": true
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
L'agent exécute la même boucle que le chat interactif : il peut appeler plusieurs outils, raisonner sur le contexte et produire une réponse réfléchie. Une tâche qui n'est pas terminée renvoie un JSON contenant `taskId`, `status`, `pollAfterMs`, et :
|
|
222
|
+
|
|
223
|
+
```json
|
|
224
|
+
{
|
|
225
|
+
"poll": {
|
|
226
|
+
"tool": "ask_app_status",
|
|
227
|
+
"arguments": { "app": "mail", "taskId": "task_123" }
|
|
214
228
|
}
|
|
215
229
|
}
|
|
216
230
|
```
|
|
217
231
|
|
|
218
|
-
|
|
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.
|
|
219
233
|
|
|
220
234
|
## Authentification {#authentication}
|
|
221
235
|
|
|
@@ -233,7 +247,7 @@ Le point de terminaison MCP prend en charge le modèle distant standard MCP OAut
|
|
|
233
247
|
Pour les hôtes MCP compatibles OAuth, configurez le serveur distant URL sans en-têtes statiques :
|
|
234
248
|
|
|
235
249
|
```bash
|
|
236
|
-
claude mcp add --transport http agent-native https://dispatch.agent-native.com/
|
|
250
|
+
claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
|
|
237
251
|
```
|
|
238
252
|
|
|
239
253
|
La première requête MCP non authentifiée reçoit :
|
|
@@ -249,9 +263,9 @@ Points de terminaison de découverte :
|
|
|
249
263
|
| ----------------------------------------- | ---------------------------------------------------------- |
|
|
250
264
|
| `/.well-known/oauth-protected-resource` | Métadonnées de ressources protégées RFC 9728 |
|
|
251
265
|
| `/.well-known/oauth-authorization-server` | Métadonnées du serveur d'autorisation OAuth |
|
|
252
|
-
| `/
|
|
253
|
-
| `/
|
|
254
|
-
| `/
|
|
266
|
+
| `/mcp/oauth/register` | Inscription dynamique du client public |
|
|
267
|
+
| `/mcp/oauth/authorize` | Autorisation du navigateur + consentement |
|
|
268
|
+
| `/mcp/oauth/token` | Accords de code d'autorisation et de jeton d'actualisation |
|
|
255
269
|
|
|
256
270
|
<Diagram id="doc-block-l7acbd" title={"Flux de découverte OAuth"} summary={"Un 401 lance la découverte, l'enregistrement et un PKCE autorisation → échange de jetons. Le jeton Bearer est limité au public et limité."}>
|
|
257
271
|
|
|
@@ -351,7 +365,7 @@ export default defineNitroPlugin(async (nitro) => {
|
|
|
351
365
|
Vous disposez d'une application d'analyse déployée sur `analytics.example.com`. À partir du code Claude :
|
|
352
366
|
|
|
353
367
|
```bash
|
|
354
|
-
claude mcp add --transport http analytics https://analytics.example.com/
|
|
368
|
+
claude mcp add --transport http analytics https://analytics.example.com/mcp
|
|
355
369
|
```
|
|
356
370
|
|
|
357
371
|
Ou ajoutez-le à la main dans `.mcp.json` :
|
|
@@ -362,7 +376,7 @@ Ou ajoutez-le à la main dans `.mcp.json` :
|
|
|
362
376
|
"mcpServers": {
|
|
363
377
|
"analytics": {
|
|
364
378
|
"type": "http",
|
|
365
|
-
"url": "https://analytics.example.com/
|
|
379
|
+
"url": "https://analytics.example.com/mcp",
|
|
366
380
|
},
|
|
367
381
|
},
|
|
368
382
|
}
|
|
@@ -12,7 +12,7 @@ L'application Agent-Native **Plan** est livrée comme un bundle installable. Une
|
|
|
12
12
|
Une installation vous offre :
|
|
13
13
|
|
|
14
14
|
- **Trois skills** — `/visual-plan` (le point d'entrée canonique), `/visual-recap` et `/visualize-repo`.
|
|
15
|
-
- **Le connecteur Plan MCP** — enregistré auprès de l'application hébergée sur `https://plan.agent-native.com` (point de terminaison MCP `https://plan.agent-native.com/
|
|
15
|
+
- **Le connecteur Plan MCP** — enregistré auprès de l'application hébergée sur `https://plan.agent-native.com` (point de terminaison MCP `https://plan.agent-native.com/mcp`, nom de serveur `plan`).
|
|
16
16
|
|
|
17
17
|
<Diagram id="doc-block-1il4uk9" title={"Trois itinéraires, un forfait"} summary={"Le CLI universel, le plugin Claude Code et le plugin Codex installent les mêmes skills Plan ainsi que le connecteur Plan hébergé."}>
|
|
18
18
|
|
|
@@ -43,7 +43,7 @@ Une installation vous offre :
|
|
|
43
43
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
44
44
|
<div class="diagram-box">
|
|
45
45
|
Plan MCP connector<br /><small class="diagram-muted"
|
|
46
|
-
>plan.agent-native.com/
|
|
46
|
+
>plan.agent-native.com/mcp</small
|
|
47
47
|
>
|
|
48
48
|
</div>
|
|
49
49
|
</div>
|
|
@@ -251,7 +251,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
|
|
|
251
251
|
codex mcp login plan # OAuth dans le navigateur
|
|
252
252
|
```
|
|
253
253
|
|
|
254
|
-
Après l'installation, **démarrez un nouveau thread Codex** pour que les outils skills et MCP se chargent dans la session. Le plugin est livré avec un connecteur uniquement URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/
|
|
254
|
+
Après l'installation, **démarrez un nouveau thread Codex** pour que les outils skills et MCP se chargent dans la session. Le plugin est livré avec un connecteur uniquement URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`) ; `codex mcp login plan` exécute le flux OAuth. La route universelle CLI ci-dessus fonctionne également pour Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si vous préférez une commande qui s'installe et s'authentifie ensemble, ou lorsque vous souhaitez des fichiers locaux ou un mode auto-hébergé.
|
|
255
255
|
|
|
256
256
|
> **Installations plus anciennes :** si votre configuration a toujours une entrée `agent-native-plans` pointant vers le même URL, exécutant `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` pour Codex, ou la même commande avec votre `--client` cible, la consolide avec le nom canonique `plan`.
|
|
257
257
|
|
|
@@ -271,7 +271,7 @@ Le framework monte ses propres routes sous `/_agent-native/`. Traitez cet espace
|
|
|
271
271
|
| `/_agent-native/extensions/*` | Extensions d'exécution et proxy d'extension (alias hérité : `/_agent-native/tools/*`) |
|
|
272
272
|
| `/_agent-native/integrations/*` | Intégrations de messagerie/webhook |
|
|
273
273
|
| `/_agent-native/a2a` | Agent à agent JSON-RPC |
|
|
274
|
-
| `/
|
|
274
|
+
| `/mcp` | Point de terminaison MCP |
|
|
275
275
|
| `/_agent-native/onboarding/*` | Liste de contrôle de configuration |
|
|
276
276
|
| `/_agent-native/observability/*` | Traces, retours, évaluations, expériences |
|
|
277
277
|
| `/_agent-native/file-upload` | Point de terminaison du fournisseur de téléchargement de fichiers |
|
|
@@ -467,4 +467,4 @@ const handler = createProductionAgentHandler({
|
|
|
467
467
|
- [**Base de données**](/docs/database) — le modèle `getDb()`/`schema` importé par les routes personnalisées et les actions
|
|
468
468
|
- [**Sécurité**](/docs/security#access-guards) — `accessFilter`/`assertAccess` et le modèle complet de portée des données
|
|
469
469
|
- [**Messagerie**](/docs/messaging) — le modèle canonique de file d'attente d'intégration pour les webhooks entrants
|
|
470
|
-
- [**Protocole MCP**](/docs/mcp-protocol) — le point de terminaison `/
|
|
470
|
+
- [**Protocole MCP**](/docs/mcp-protocol) — le point de terminaison `/mcp` que ce serveur monte automatiquement
|
|
@@ -313,7 +313,7 @@ Chaque compétence basée sur l'application commence par `agent-native.app-skill
|
|
|
313
313
|
"id": "assets",
|
|
314
314
|
"hosted": {
|
|
315
315
|
"url": "https://assets.agent-native.com",
|
|
316
|
-
"mcpUrl": "https://assets.agent-native.com/
|
|
316
|
+
"mcpUrl": "https://assets.agent-native.com/mcp"
|
|
317
317
|
},
|
|
318
318
|
"mcp": { "serverName": "agent-native-assets" },
|
|
319
319
|
"skills": [
|
|
@@ -495,7 +495,7 @@ sélecteur humain UI.
|
|
|
495
495
|
### Développeur : distribuer la compétence d'application
|
|
496
496
|
|
|
497
497
|
La compétence d'application Actifs porte l'ID d'application `assets` et héberge MCP URL
|
|
498
|
-
`https://assets.agent-native.com/
|
|
498
|
+
`https://assets.agent-native.com/mcp`.
|
|
499
499
|
|
|
500
500
|
```bash
|
|
501
501
|
# Installation hébergée la plus simple : instructions de compétences exportées et connecteur MCP.
|
|
@@ -123,7 +123,7 @@ Au quotidien, Dispatch est l'endroit où les administrateurs et les opérationne
|
|
|
123
123
|
Distribuez l'accès sans copier les secrets bruts. Source spécifique à l'application
|
|
124
124
|
la configuration reste dans l'application qui utilise le fournisseur.
|
|
125
125
|
- **Exposer un connecteur MCP.** Ajouter
|
|
126
|
-
`https://dispatch.agent-native.com/
|
|
126
|
+
`https://dispatch.agent-native.com/mcp` dans Claude, ChatGPT,
|
|
127
127
|
Codex, Cursor ou un autre hôte MCP, puis choisissez les applications d'espace de travail qui
|
|
128
128
|
peut être atteint depuis la page **Agents** de Dispatch. Utiliser une application directe URL
|
|
129
129
|
uniquement lorsque cet hôte doit être isolé sur une seule application.
|
|
@@ -304,7 +304,7 @@ _Comment ça marche sous le capot (pour les développeurs)._
|
|
|
304
304
|
]}
|
|
305
305
|
/>
|
|
306
306
|
|
|
307
|
-
- **Mode hub MCP.** Dispatch peut toujours agir comme [MCP hub](/docs/mcp-clients#hub) de l'espace de travail, de sorte que toutes les autres applications de l'espace de travail extraient la même liste de serveurs MCP de portée organisationnelle. Par ailleurs, le point de terminaison `/
|
|
307
|
+
- **Mode hub MCP.** Dispatch peut toujours agir comme [MCP hub](/docs/mcp-clients#hub) de l'espace de travail, de sorte que toutes les autres applications de l'espace de travail extraient la même liste de serveurs MCP de portée organisationnelle. Par ailleurs, le point de terminaison `/mcp` de Dispatch est le connecteur externe MCP recommandé pour Claude, ChatGPT et d'autres hôtes qui doivent atteindre plusieurs applications d'espace de travail.
|
|
308
308
|
|
|
309
309
|
## Rêves {#dreams}
|
|
310
310
|
|
|
@@ -114,7 +114,7 @@ La commande installe trois commandes : `/visual-plan`, `/visual-recap` et `/visu
|
|
|
114
114
|
|
|
115
115
|
Si vous utilisez un hôte basé sur le chat qui accepte directement les connecteurs MCP URL
|
|
116
116
|
(plutôt qu'un client configuré avec CLI), connectez le connecteur Plans hébergés à
|
|
117
|
-
`https://plan.agent-native.com/
|
|
117
|
+
`https://plan.agent-native.com/mcp` : voir [MCP Clients](/docs/mcp-clients) pour la configuration spécifique au client.
|
|
118
118
|
|
|
119
119
|
L'authentification consiste en une connexion unique au navigateur lors de la configuration : c'est prévu, et c'est le cas
|
|
120
120
|
est ce qui permet à l'agent de persister et de partager les plans qu'il génère. Quelle est l'authentification
|
|
@@ -253,7 +253,7 @@ Le partage et les commentaires sont les workflows qui nécessitent un compte :
|
|
|
253
253
|
examen multi-appareils ou d'équipe) nécessite une connexion. La connexion à Google apparaît lorsque
|
|
254
254
|
les variables d'environnement Google OAuth standard sont configurées.
|
|
255
255
|
|
|
256
|
-
Le connecteur Plans hébergé se trouve sur `https://plan.agent-native.com/
|
|
256
|
+
Le connecteur Plans hébergé se trouve sur `https://plan.agent-native.com/mcp`.
|
|
257
257
|
Ne mettez jamais de secrets partagés dans les fichiers de compétences.
|
|
258
258
|
|
|
259
259
|
## Mode de confidentialité des fichiers locaux {#local-files}
|
|
@@ -452,7 +452,7 @@ pnpm dev
|
|
|
452
452
|
La compétence basée sur l'application hébergée utilise :
|
|
453
453
|
|
|
454
454
|
- Application : `https://plan.agent-native.com`
|
|
455
|
-
- MCP: `https://plan.agent-native.com/
|
|
455
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
456
456
|
|
|
457
457
|
Le modèle local est utile lorsque vous développez Plans lui-même, testez la persistance locale ou exécutez une surface de révision entièrement auto-hébergée.
|
|
458
458
|
|
|
@@ -536,7 +536,7 @@ JSON इनपुट एजेंटों और जटिल वस्तु
|
|
|
536
536
|
|
|
537
537
|
## इसे MCP पर उजागर करना {#mcp}
|
|
538
538
|
|
|
539
|
-
MCP सक्षम होने पर, आपका actions फ्रेमवर्क के MCP सर्वर में `/
|
|
539
|
+
MCP सक्षम होने पर, आपका actions फ्रेमवर्क के MCP सर्वर में `/mcp` पर दिखाई देता है। प्रत्येक कॉल करने वाले को डिफ़ॉल्ट रूप से एक कॉम्पैक्ट कैटलॉग मिलता है - ऐप-फेसिंग बिल्टिन और टेम्पलेट-घोषित ऐप actions - और `tool-search` हमेशा मौजूद रहता है ताकि कोई भी अन्य टूल मांग पर उपलब्ध रहे। पूर्ण क्रिया सतह केवल स्पष्ट ऑप्ट-इन (`--full-catalog` टोकन या `AGENT_NATIVE_MCP_FULL_CATALOG=1`) पर प्रदान की जाती है, और `publicAgent.expose` सार्वजनिक सतह पर एक सुरक्षित रीड/इन्जेस्ट टूल का विकल्प चुनता है। कैटलॉग टियर, ऑथ और `mcpApp` संसाधन विवरण के लिए [MCP Protocol](/docs/mcp-protocol) देखें।
|
|
540
540
|
|
|
541
541
|
UI-सक्षम MCP होस्ट के लिए, एक क्रिया `mcpApp` फ़ील्ड (साथ ही एक मिलान `link`) के माध्यम से एक वैकल्पिक MCP ऐप्स संसाधन घोषित कर सकती है ताकि सक्षम होस्ट परिणाम इनलाइन प्रस्तुत कर सकें। जब `link` और `mcpApp` को एक ही मार्ग पर इंगित करना चाहिए, तो `embedRoute()` दोनों को एक शुद्ध पथ बिल्डर से बनाता है:
|
|
542
542
|
|
|
@@ -219,7 +219,7 @@ ACCESS_TOKENS=token1,token2,token3
|
|
|
219
219
|
प्रत्येक ऐप का MCP एंडपॉइंट एक मानक संरक्षित MCP संसाधन के रूप में कार्य कर सकता है। OAuth-सक्षम क्लाइंट को केवल दूरस्थ MCP URL के साथ कॉन्फ़िगर किया जा सकता है:
|
|
220
220
|
|
|
221
221
|
```text
|
|
222
|
-
https://mail.agent-native.com/
|
|
222
|
+
https://mail.agent-native.com/mcp
|
|
223
223
|
```
|
|
224
224
|
|
|
225
225
|
अप्रमाणित MCP अनुरोध `/.well-known/oauth-protected-resource` की ओर इशारा करते हुए एक `WWW-Authenticate` चुनौती लौटाते हैं। क्लाइंट तब ऐप के OAuth मेटाडेटा को खोजता है, गतिशील रूप से एक सार्वजनिक क्लाइंट को पंजीकृत करता है, ऐप के प्राधिकरण पृष्ठ को खोलता है, और एक्सेस और रीफ्रेश टोकन के लिए PKCE के साथ एक प्राधिकरण कोड का आदान-प्रदान करता है।
|
|
@@ -113,16 +113,16 @@ Slack, ईमेल, टेलीग्राम और व्हाट्सए
|
|
|
113
113
|
|
|
114
114
|
### एकीकृत MCP गेटवे
|
|
115
115
|
|
|
116
|
-
डिस्पैच बाहरी एजेंटों के लिए एकल MCP कनेक्टर हो सकता है: Claude, ChatGPT, Codex, या कर्सर में एक बार `https://dispatch.agent-native.com/
|
|
116
|
+
डिस्पैच बाहरी एजेंटों के लिए एकल MCP कनेक्टर हो सकता है: Claude, ChatGPT, Codex, या कर्सर में एक बार `https://dispatch.agent-native.com/mcp` जोड़ें, और प्रति ऐप एक कनेक्टर के बजाय एक प्राधिकरण प्रत्येक स्वीकृत कार्यक्षेत्र ऐप तक पहुंचता है। संपूर्ण कनेक्ट फ़्लो, ऐप अनुदान, OAuth और इनलाइन MCP ऐप पूर्वावलोकन के लिए [External Agents](/docs/external-agents) देखें।
|
|
117
117
|
|
|
118
|
-
<Endpoint id="doc-block-n41avw" method="POST" path="/
|
|
118
|
+
<Endpoint id="doc-block-n41avw" method="POST" path="/mcp" summary={"एकीकृत MCP गेटवे समापन बिंदु"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
|
|
119
119
|
{
|
|
120
120
|
"status": "200",
|
|
121
121
|
"description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps."
|
|
122
122
|
}
|
|
123
123
|
]}>
|
|
124
124
|
|
|
125
|
-
The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/
|
|
125
|
+
The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
|
|
126
126
|
|
|
127
127
|
</Endpoint>
|
|
128
128
|
|
|
@@ -98,7 +98,7 @@ search: "Claude ChatGPT Claude कोड Codex कर्सर Claude कोव
|
|
|
98
98
|
कार्यस्थान या क्रॉस-ऐप कार्य के लिए, डिस्पैच का उपयोग करें:
|
|
99
99
|
|
|
100
100
|
```text
|
|
101
|
-
https://dispatch.agent-native.com/
|
|
101
|
+
https://dispatch.agent-native.com/mcp
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
डिस्पैच मेल, कैलेंडर, एनालिटिक्स, ब्रेन और आपके लिए एकल गेटवे है
|
|
@@ -109,12 +109,12 @@ https://dispatch.agent-native.com/_agent-native/mcp
|
|
|
109
109
|
जानबूझकर अलग किए गए किसी ऐप के लिए, सीधे उस ऐप का उपयोग करें:
|
|
110
110
|
|
|
111
111
|
```text
|
|
112
|
-
https://mail.agent-native.com/
|
|
113
|
-
https://<your-app>.agent-native.com/
|
|
112
|
+
https://mail.agent-native.com/mcp
|
|
113
|
+
https://<your-app>.agent-native.com/mcp
|
|
114
114
|
```
|
|
115
115
|
|
|
116
116
|
प्रत्येक होस्ट किए गए ऐप में एक सहायक पृष्ठ भी होता है
|
|
117
|
-
`https://<app>/
|
|
117
|
+
`https://<app>/mcp/connect` प्रतिलिपि योग्य URL और
|
|
118
118
|
Claude, ChatGPT, कर्सर, Claude कोड, Codex और अन्य के लिए होस्ट-विशिष्ट टैब।
|
|
119
119
|
|
|
120
120
|
### Claude और ChatGPT OAuth {#oauth}
|
|
@@ -237,7 +237,7 @@ npx @agent-native/core@latest connect https://mail.agent-native.com
|
|
|
237
237
|
npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
|
|
238
238
|
```
|
|
239
239
|
|
|
240
|
-
`reconnect` किसी भी MCP कॉन्फ़िगरेशन प्रविष्टि को ढूंढता है जिसका URL दिए गए होस्ट और चयनित क्लाइंट के लिए `/
|
|
240
|
+
`reconnect` किसी भी MCP कॉन्फ़िगरेशन प्रविष्टि को ढूंढता है जिसका URL दिए गए होस्ट और चयनित क्लाइंट के लिए `/mcp` में समाप्त होता है (कनेक्टर नाम की परवाह किए बिना URL द्वारा मिलान), फिर आपके स्थापित skills को छूने या पूर्ण इंस्टॉल प्रवाह को फिर से चलाने के बिना प्रामाणिक सामग्री को ताज़ा या प्रतिस्थापित करता है। आधार ऐप URL (जैसे `https://plan.agent-native.com`) पास करें - `/mcp` प्रत्यय का अनुमान लगाया गया है। प्रमाणीकरण और टूल लोडिंग प्रति क्लाइंट है, इसलिए बाद में उस क्लाइंट को पुनरारंभ/पुनः लोड करें; नए लोड किए गए टूल प्रदर्शित होने से पहले Codex को एक नए सत्र की आवश्यकता है।
|
|
241
241
|
|
|
242
242
|
Claude कोड में, समतुल्य UI पथ है: `/mcp` चलाएं और प्रासंगिक कनेक्टर के लिए **प्रमाणीकृत** (या **पुन: कनेक्ट**) चुनें।
|
|
243
243
|
|
|
@@ -245,7 +245,7 @@ Claude कोड में, समतुल्य UI पथ है: `/mcp` च
|
|
|
245
245
|
|
|
246
246
|
### पेज फ़ॉलबैक कनेक्ट करें {#connect-page-fallback}
|
|
247
247
|
|
|
248
|
-
MCP क्लाइंट के लिए जो सीधे रिमोट OAuth URL नहीं जोड़ सकते हैं, अपने ब्राउज़र में ऐप खोलें और इसके **कनेक्ट** अफोर्डेंस (`https://<app>/
|
|
248
|
+
MCP क्लाइंट के लिए जो सीधे रिमोट OAuth URL नहीं जोड़ सकते हैं, अपने ब्राउज़र में ऐप खोलें और इसके **कनेक्ट** अफोर्डेंस (`https://<app>/mcp/connect` पर उपलब्ध) का उपयोग करें। लॉग इन करते समय, **कनेक्ट/अधिकृत** पर क्लिक करें। पेज आपको या तो एक-क्लिक डीप लिंक देता है जो किसी खोजे गए एजेंट को कॉन्फ़िगर करता है, या एक रेडी-टू-पेस्ट `.mcp.json` ब्लॉक देता है:
|
|
249
249
|
|
|
250
250
|
```jsonc
|
|
251
251
|
// .mcp.json
|
|
@@ -253,7 +253,7 @@ MCP क्लाइंट के लिए जो सीधे रिमोट O
|
|
|
253
253
|
"mcpServers": {
|
|
254
254
|
"mail": {
|
|
255
255
|
"type": "http",
|
|
256
|
-
"url": "https://mail.agent-native.com/
|
|
256
|
+
"url": "https://mail.agent-native.com/mcp",
|
|
257
257
|
"headers": { "Authorization": "Bearer <minted-token>" },
|
|
258
258
|
},
|
|
259
259
|
},
|
|
@@ -270,13 +270,13 @@ MCP क्लाइंट के लिए जो सीधे रिमोट O
|
|
|
270
270
|
|
|
271
271
|
```bash
|
|
272
272
|
claude mcp add --transport http agent-native \
|
|
273
|
-
https://dispatch.agent-native.com/
|
|
273
|
+
https://dispatch.agent-native.com/mcp
|
|
274
274
|
```
|
|
275
275
|
|
|
276
276
|
यह वही URL-केवल प्रविष्टि है जिसे `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` आपके लिए लिखता है। फिर Claude कोड में `/mcp` चलाएं और **प्रमाणित करें** चुनें। क्लाइंट MCP सर्वर के `401 WWW-Authenticate` चुनौती से प्रमाणीकरण खोजता है, `/.well-known/oauth-protected-resource` और `/.well-known/oauth-authorization-server` प्राप्त करता है, गतिशील रूप से एक सार्वजनिक OAuth क्लाइंट पंजीकृत करता है, ऐप का प्राधिकरण पृष्ठ खोलता है, और परिणामी टोकन को सुरक्षित रूप से संग्रहीत करता है। ChatGPT डेवलपर-मोड कनेक्टर एक ही सर्वर URL का उपयोग करते हैं:
|
|
277
277
|
|
|
278
278
|
```text
|
|
279
|
-
https://dispatch.agent-native.com/
|
|
279
|
+
https://dispatch.agent-native.com/mcp
|
|
280
280
|
```
|
|
281
281
|
|
|
282
282
|
OAuth प्रवाह ताज़ा-टोकन रोटेशन के साथ प्राधिकरण-कोड + PKCE है। एक्सेस टोकन सटीक MCP संसाधन URL के लिए ऑडियंस-बाउंड हैं और हस्ताक्षरित उपयोगकर्ता/संगठन पहचान रखते हैं, इसलिए टूल कॉल, `resources/read`, और MCP ऐप iframe-आरंभित `tools/call` सभी मौजूदा कनेक्ट-मिंटेड JWT पथ के समान `runWithRequestContext` किरायेदार स्कोपिंग के माध्यम से चलते हैं। iframe को कभी भी कच्चा OAuth टोकन प्राप्त नहीं होता है; होस्ट प्रमाणित MCP कनेक्शन के माध्यम से कॉल में मध्यस्थता करता है।
|
|
@@ -500,13 +500,13 @@ ChatGPT/Claude-शैली OAuth ऐप होस्ट के लिए, ख
|
|
|
500
500
|
|
|
501
501
|
प्रति-क्रिया टूल के शीर्ष पर MCP सर्वर एक स्थिर क्रिया सेट को उजागर करता है, इसलिए एक बाहरी एजेंट के पास प्रति-ऐप कार्रवाई नामों का अनुमान लगाए बिना एक पूर्वानुमानित सतह होती है:
|
|
502
502
|
|
|
503
|
-
| उपकरण | दुष्प्रभाव | रिटर्न
|
|
504
|
-
| -------------------------------------------------- | ---------- |
|
|
505
|
-
| `list_apps` | कोई नहीं | कार्यस्थान ऐप्स + उनकी URLs/चलने की स्थिति
|
|
506
|
-
| `open_app({ app, view?, path?, params?, embed? })` | कोई नहीं | एक गहरा लिंक या समान मूल मार्ग; `embed: true` जहां समर्थित है वहां पूर्ण ऐप इनलाइन प्रस्तुत करता है
|
|
507
|
-
| `ask_app({ app, message })`
|
|
508
|
-
| `create_workspace_app({ name, template })` | मचान | कार्यस्थान पथ के माध्यम से बूट किया गया एक नया ऐप, साथ ही इसका चल रहा URL + डीप लिंक
|
|
509
|
-
| `list_templates` | कोई नहीं | केवल अनुमति-सूचीबद्ध टेम्पलेट
|
|
503
|
+
| उपकरण | दुष्प्रभाव | रिटर्न |
|
|
504
|
+
| -------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
505
|
+
| `list_apps` | कोई नहीं | कार्यस्थान ऐप्स + उनकी URLs/चलने की स्थिति |
|
|
506
|
+
| `open_app({ app, view?, path?, params?, embed? })` | कोई नहीं | एक गहरा लिंक या समान मूल मार्ग; `embed: true` जहां समर्थित है वहां पूर्ण ऐप इनलाइन प्रस्तुत करता है |
|
|
507
|
+
| `ask_app({ app, message, async?, maxWaitMs? })` | एजेंट लूप | एक प्राकृतिक-भाषा कार्य को उस ऐप के इन-ऐप एजेंट तक पहुंचाता है; लंबे काम के लिए `ask_app_status` पोलिंग हेतु एक स्थायी `taskId` लौटाया जाता है |
|
|
508
|
+
| `create_workspace_app({ name, template })` | मचान | कार्यस्थान पथ के माध्यम से बूट किया गया एक नया ऐप, साथ ही इसका चल रहा URL + डीप लिंक |
|
|
509
|
+
| `list_templates` | कोई नहीं | केवल अनुमति-सूचीबद्ध टेम्पलेट |
|
|
510
510
|
|
|
511
511
|
`create_workspace_app` किसी भी गैर-अनुमति-सूचीबद्ध टेम्पलेट को अस्वीकार करता है - `packages/shared-app-config/templates.ts` में सार्वजनिक टेम्पलेट अनुमति-सूची आधिकारिक और सीआई-संरक्षित है; कोई बाहरी एजेंट इसे चौड़ा नहीं कर सकता. एक समान-नामित टेम्पलेट क्रिया एक बिल्टिन (टेम्पलेट-ओवर-कोर प्राथमिकता) को ओवरराइड करती है। `MCPConfig.builtinCrossAppTools: false` के साथ पूरे सेट को अक्षम करें।
|
|
512
512
|
|
|
@@ -514,6 +514,18 @@ ChatGPT/Claude-शैली OAuth ऐप होस्ट के लिए, ख
|
|
|
514
514
|
|
|
515
515
|
तेज़ ChatGPT/Claude हैंडऑफ़ के लिए, आदर्श पथ सीधा है: उस क्रिया को कॉल करें जो आर्टिफैक्ट बनाता है या खोलता है, फिर MCP ऐप को रूट लॉन्च करने दें। एक मेल अनुरोध को `manage_draft` पर कॉल करना चाहिए और वास्तविक कंपोज़ रूट प्रस्तुत करना चाहिए। डैशबोर्ड अनुरोध को `open_app({ path, embed: true })` या `mcpApp` के साथ डैशबोर्ड कार्रवाई को कॉल करना चाहिए और संपूर्ण एनालिटिक्स रूट प्रस्तुत करना चाहिए। कैलेंडर, फॉर्म, सामग्री, स्लाइड, डिज़ाइन और क्लिप्स को अपने ड्राफ्ट/निर्माण/खोज actions के साथ समान पैटर्न का पालन करना चाहिए। `list_apps` तब उपयोगी होता है जब मॉडल को स्वीकृत ऐप्स में से चयन करना होता है; व्यापक `resources/list`, पूर्ण-कैटलॉग खोज, या `ask_app` प्रतिनिधिमंडल स्पष्ट UI हैंडऑफ़ के लिए सामान्य मार्ग नहीं होना चाहिए।
|
|
516
516
|
|
|
517
|
+
### लंबे समय तक चलने वाले एजेंट अनुरोध
|
|
518
|
+
|
|
519
|
+
MCP होस्ट और गेटवे एक साझा लंबे टूल-कॉल टाइमआउट का उपयोग नहीं करते; कुछ पांच
|
|
520
|
+
मिनट की सीमा लागू करते हैं और अन्य कॉन्फ़िगर करने योग्य हैं। दस मिनट के
|
|
521
|
+
ब्लॉकिंग `tools/call` के इर्द-गिर्द बाहरी एजेंट एकीकरण डिज़ाइन न करें।
|
|
522
|
+
`ask-agent` और `ask_app` होस्ट किए गए कार्य को जल्दी स्वीकार करते हैं, फिर
|
|
523
|
+
इनलाइन प्रतीक्षा समाप्त होने पर एक स्थायी `taskId` लौटाते हैं। लौटाए गए
|
|
524
|
+
`app` और `taskId` का उपयोग करके `ask_app_status` के साथ पोल करें; परिणाम में
|
|
525
|
+
एक होस्ट-अनुकूल अंतराल के रूप में `pollAfterMs` शामिल है। पहली प्रतिक्रिया के
|
|
526
|
+
टाइमआउट होने से पहले टास्क बनाया जाना चाहिए, इसलिए केवल लंबे कॉल के बाद
|
|
527
|
+
लौटाया गया पोलिंग URL एक विश्वसनीय रिकवरी अनुबंध नहीं है।
|
|
528
|
+
|
|
517
529
|
### प्रति-ऐप टूर {#tour}
|
|
518
530
|
|
|
519
531
|
प्रत्येक अनुमति-सूचीबद्ध टेम्पलेट जो एक नेविगेशन योग्य संसाधन का उत्पादन या सूचीबद्ध करता है, एक `link` बिल्डर को शिप करता है, और अंतर्ग्रहण-भारी वाले एक GET + `publicAgent` कार्रवाई को शिप करते हैं ताकि एक कनेक्टेड एजेंट लाइव स्थिति खींच सके:
|
|
@@ -677,7 +689,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
|
|
|
677
689
|
- **सहकर्मी** - `~/.cowork/mcp.json` में समान Claude कोड JSON आकार।
|
|
678
690
|
- **कोडेक्स** - `~/.codex/config.toml` में एक `[mcp_servers.<name>]` ब्लॉक।
|
|
679
691
|
|
|
680
|
-
प्रविष्टि `npx @agent-native/core@latest mcp serve --app <id>` चलाती है, जो डिफ़ॉल्ट रूप से चल रहे स्थानीय ऐप के `/
|
|
692
|
+
प्रविष्टि `npx @agent-native/core@latest mcp serve --app <id>` चलाती है, जो डिफ़ॉल्ट रूप से चल रहे स्थानीय ऐप के `/mcp` के लिए एक **पतली stdio प्रॉक्सी** है - इसलिए लाइव एक्शन रजिस्ट्री, HMR और सही डीप लिंक सत्य का एकल स्रोत बने रहते हैं। इसके बजाय प्रक्रिया में रजिस्ट्री बनाने के लिए `--standalone` पास करें। जब `npx @agent-native/core@latest mcp install` एक होस्टेड मूल (कार्यस्थान `.env` में एक गैर-लोकलहोस्ट `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`) का पता लगाता है, तो यह एक stdio प्रविष्टि के बजाय `Bearer` JWT के साथ `<origin>/mcp` की ओर इशारा करते हुए एक `http` क्लाइंट प्रविष्टि लिखता है।
|
|
681
693
|
|
|
682
694
|
सहयोगी उपकमांड:
|
|
683
695
|
|
|
@@ -701,7 +713,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
|
|
|
701
713
|
"mcpServers": {
|
|
702
714
|
"analytics": {
|
|
703
715
|
"type": "http",
|
|
704
|
-
"url": "https://analytics.agent-native.com/
|
|
716
|
+
"url": "https://analytics.agent-native.com/mcp",
|
|
705
717
|
"headers": { "Authorization": "Bearer <ACCESS_TOKEN-or-JWT>" },
|
|
706
718
|
},
|
|
707
719
|
},
|
|
@@ -743,7 +755,7 @@ npx @agent-native/core@latest connect prod --apps mail,calendar,analytics --clie
|
|
|
743
755
|
फ़ॉलबैक होस्ट किया गया `connect` प्रवाह कभी भी परिनियोजन के साझा रहस्य की प्रतिलिपि नहीं बनाता है। इसके बजाय:
|
|
744
756
|
|
|
745
757
|
- एक लॉग-इन ब्राउज़र सत्र एक **प्रति-उपयोगकर्ता, स्कोप्ड, रिवोकेबल** टोकन बनाता है - एक `A2A_SECRET`-हस्ताक्षरित JWT जिसमें कॉलर का `sub` + `org_domain` और एक अद्वितीय `jti` होता है, इसलिए प्रत्येक टूल रन `runWithRequestContext` के माध्यम से टेनेंट-स्कोप्ड रहता है।
|
|
746
|
-
- मौजूदा `/
|
|
758
|
+
- मौजूदा `/mcp` एंडपॉइंट किसी भी अन्य वाहक की तरह उस टोकन को स्वीकार करता है ([MCP Protocol](/docs/mcp-protocol) देखें) - कोई नया एंडपॉइंट नहीं, कोई नया ट्रांसपोर्ट नहीं।
|
|
747
759
|
- वही कनेक्ट पेज आपके द्वारा बनाए गए प्रत्येक टोकन को सूचीबद्ध करता है और आपको `jti` द्वारा उनमें से किसी को **निरस्त** करने देता है। उनके साथ व्यक्तिगत एक्सेस टोकन की तरह व्यवहार करें: प्रति एजेंट क्लाइंट के लिए एक, मशीन बंद होने पर रद्द कर दें।
|
|
748
760
|
- एजेंट जिस डीप लिंक को वापस सौंपता है उसमें कोई विशेषाधिकार प्राप्त स्थिति नहीं होती है। रिकॉर्ड-फ़ोकस करने वाला `navigate` लेखन हमेशा **ब्राउज़र** सत्र तक सीमित होता है, एजेंट का टोकन कभी नहीं - इसलिए एक लिंक टर्मिनल या चैट ट्रांसक्रिप्ट में पेस्ट करना सुरक्षित होता है।
|
|
749
761
|
|
|
@@ -245,6 +245,18 @@ MCP उपकरण केवल नोड रनटाइम में सक
|
|
|
245
245
|
|
|
246
246
|
MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर आपके एजेंट को नई क्षमताएं देते हैं - जैसे जैपियर, क्लाउडफ्लेयर, कंपोज़ियो या आपकी कंपनी के आंतरिक टूल से कनेक्ट करना। एक बार कनेक्ट होने के बाद, एजेंट उन टूल्स का उपयोग अपने बिल्ट-इन टूल्स की तरह ही कर सकता है।
|
|
247
247
|
|
|
248
|
+
प्रीसेट आईडी `context7`, `sentry`, `notion`, `semgrep`, `linear`,
|
|
249
|
+
`atlassian`, `supabase`, `neon` और `stripe` हैं।
|
|
250
|
+
|
|
251
|
+
### Atlassian / Jira
|
|
252
|
+
|
|
253
|
+
Atlassian प्रीसेट, Atlassian Rovo MCP के OAuth 2.1 एंडपॉइंट
|
|
254
|
+
`https://mcp.atlassian.com/v1/mcp/authv2` का उपयोग करता है और Jira तथा Confluence टूल उपलब्ध कराता है। Jira टिकट बनाने के लिए Atlassian की वे अनुमतियां आवश्यक हैं जो Jira में लिखने की अनुमति देती हैं; उपयोगकर्ता को फिर भी केवल वही प्रोजेक्ट और सामग्री दिखाई देती है जिसकी अनुमति उसके Atlassian खाते को है।
|
|
255
|
+
|
|
256
|
+
Atlassian संगठन के व्यवस्थापक नियंत्रित कर सकते हैं कि किसी OAuth क्लाइंट को कनेक्ट करने की अनुमति है या नहीं। कनेक्ट करने से पहले, किसी व्यवस्थापक को ऐप का वास्तविक HTTPS ओरिजिन **Atlassian Administration → Rovo → Rovo MCP server → Domains** के अंतर्गत विश्वसनीय डोमेन सूची में जोड़ना पड़ सकता है और **Permissions** के अंतर्गत आवश्यक **Read**, **Write** और **Search** अनुमतियां सक्षम करनी पड़ सकती हैं। डोमेन वही होस्ट होना चाहिए जहां agent-native ऐप चलता है; `https://builder.io/**` को किसी अन्य डिप्लॉयमेंट में कॉपी न करें, जब तक कि वह उसका वास्तविक ओरिजिन न हो। Atlassian की [Rovo MCP सेटअप गाइड](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/) और [व्यवस्थापक नियंत्रण](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/) देखें।
|
|
257
|
+
|
|
258
|
+
कैटलॉग एंडपॉइंट और सेटअप निर्देश उपलब्ध कराता है। सामान्य सेटिंग्स फ़ॉर्म एंडपॉइंट और वैकल्पिक एन्क्रिप्टेड हेडर संग्रहीत करता है; यह Atlassian के इंटरैक्टिव OAuth सहमति प्रवाह की जगह नहीं लेता। जब Atlassian को इंटरैक्टिव OAuth की आवश्यकता हो, तो OAuth-सक्षम MCP क्लाइंट या रनटाइम का उपयोग करें। यदि प्रदाता या रनटाइम स्थिर Bearer टोकन का समर्थन करता है, तो उसके अनुमोदित सीक्रेट-मैनेजमेंट तरीके का पालन करें और टोकन को कभी भी prompts या कमिट किए गए कॉन्फ़िगरेशन में पेस्ट न करें।
|
|
259
|
+
|
|
248
260
|
### दूरस्थ MCP सर्वर कैसे कनेक्ट करें
|
|
249
261
|
|
|
250
262
|
1. **सर्वर नाम** — आपके स्वयं के संदर्भ के लिए एक संक्षिप्त लेबल (उदाहरण के लिए "ज़ैपियर", "स्लैक-टूल्स")।
|
|
@@ -263,7 +275,7 @@ MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल)
|
|
|
263
275
|
|
|
264
276
|
चल रहे MCP प्रबंधक में हॉट-रीलोड जोड़ता और हटाता है - कोई प्रक्रिया पुनरारंभ नहीं होती, और कोई सर्वर पुनरारंभ नहीं होता। नए `mcp__<scope>-<name>__*` उपकरण अगले संदेश पर एजेंट को दिखाई देते हैं और `tool-search` के माध्यम से खोजे जा सकते हैं।
|
|
265
277
|
|
|
266
|
-
HTTPS URLs हर जगह स्वीकार किए जाते हैं; विकास के दौरान केवल `localhost` के लिए सादे `http://` की अनुमति है। वैकल्पिक प्रमाणीकरण एक बियरर टोकन के रूप में जाता है जो प्रत्येक अनुरोध पर `Authorization: Bearer …` के माध्यम से भेजा जाता है।
|
|
278
|
+
HTTPS URLs हर जगह स्वीकार किए जाते हैं; विकास के दौरान केवल `localhost` के लिए सादे `http://` की अनुमति है। वैकल्पिक प्रमाणीकरण एक बियरर टोकन के रूप में जाता है जो प्रत्येक अनुरोध पर `Authorization: Bearer …` के माध्यम से भेजा जाता है। Atlassian Rovo MCP सहित केवल OAuth का समर्थन करने वाले प्रदाताओं को स्थिर हेडर के बजाय प्रदाता के OAuth प्रवाह की आवश्यकता होती है।
|
|
267
279
|
|
|
268
280
|
हुड के तहत ये सर्वर फ्रेमवर्क की `settings` तालिका में कुंजी `u:<email>:mcp-servers-remote` (व्यक्तिगत) या `o:<orgId>:mcp-servers-remote` (टीम) के तहत बने रहते हैं और स्टार्टअप पर `mcp.config.json` के साथ विलय हो जाते हैं।
|
|
269
281
|
|
|
@@ -292,7 +304,9 @@ Stdio सर्वर अभी भी नोड रनटाइम के ब
|
|
|
292
304
|
<div class="diagram-panel center" data-rough>
|
|
293
305
|
<span class="diagram-pill accent">Dispatch hub</span
|
|
294
306
|
><small class="diagram-muted">org-scope MCP सर्वर</small
|
|
295
|
-
><small class="diagram-muted"
|
|
307
|
+
><small class="diagram-muted"
|
|
308
|
+
><code>GET /_agent-native/mcp/hub/servers</code></small
|
|
309
|
+
>
|
|
296
310
|
</div>
|
|
297
311
|
<div class="diagram-col arrows">
|
|
298
312
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
@@ -454,7 +468,7 @@ Reports which configured servers connected, the total live tool count, the merge
|
|
|
454
468
|
|
|
455
469
|
व्यक्तिगत MCP सर्वर विफलताएं कभी भी एजेंट को निष्क्रिय नहीं करतीं:
|
|
456
470
|
|
|
457
|
-
- एक गलत कॉन्फ़िगर किया गया `command` → सर्वर छोड़ दिया गया है, इसकी त्रुटि `errors.<server-id>` के तहत `/mcp/status` में दिखाई देती है, और हर दूसरा सर्वर काम करना जारी रखता है।
|
|
471
|
+
- एक गलत कॉन्फ़िगर किया गया `command` → सर्वर छोड़ दिया गया है, इसकी त्रुटि `errors.<server-id>` के तहत `/_agent-native/mcp/status` में दिखाई देती है, और हर दूसरा सर्वर काम करना जारी रखता है।
|
|
458
472
|
- MCP SDK `node_modules` से गायब है → सभी MCP कार्यक्षमता एक चेतावनी के साथ छोड़ दी गई है; एजेंट चैट शून्य MCP टूल के साथ काम करती रहती है।
|
|
459
473
|
- एज रनटाइम में चल रहा है → MCP क्लाइंट नो-ऑप है।
|
|
460
474
|
|