@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
|
@@ -12,7 +12,7 @@ Agent-Native **Plan** 应用以一个可安装的 bundle 提供。一次安装
|
|
|
12
12
|
一次安装即可为您提供:
|
|
13
13
|
|
|
14
14
|
- **三个 skills** — `/visual-plan`(规范入口点)、`/visual-recap` 和 `/visualize-repo`。
|
|
15
|
-
- **计划 MCP 连接器** — 针对 `https://plan.agent-native.com` 上的托管应用程序进行注册(MCP 端点 `https://plan.agent-native.com/
|
|
15
|
+
- **计划 MCP 连接器** — 针对 `https://plan.agent-native.com` 上的托管应用程序进行注册(MCP 端点 `https://plan.agent-native.com/mcp`,服务器名称 `plan`)。
|
|
16
16
|
|
|
17
17
|
<Diagram id="doc-block-xt4mmz" title={"三条路线,一揽子"} summary={"通用 CLI、Claude Code 插件和 Codex 插件都会安装同一组 Plan skills 以及托管的 Plan 连接器。"}>
|
|
18
18
|
|
|
@@ -41,7 +41,7 @@ Agent-Native **Plan** 应用以一个可安装的 bundle 提供。一次安装
|
|
|
41
41
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
42
42
|
<div class="diagram-box">
|
|
43
43
|
Plan MCP connector<br /><small class="diagram-muted"
|
|
44
|
-
>plan.agent-native.com/
|
|
44
|
+
>plan.agent-native.com/mcp</small
|
|
45
45
|
>
|
|
46
46
|
</div>
|
|
47
47
|
</div>
|
|
@@ -249,7 +249,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
|
|
|
249
249
|
codex mcp login plan # 浏览器中的 OAuth
|
|
250
250
|
```
|
|
251
251
|
|
|
252
|
-
安装后,**启动新的 Codex 线程**,以便 skills 和 MCP 工具加载到会话中。该插件附带一个仅限 URL 的连接器(`[mcp_servers.plan]` → `https://plan.agent-native.com/
|
|
252
|
+
安装后,**启动新的 Codex 线程**,以便 skills 和 MCP 工具加载到会话中。该插件附带一个仅限 URL 的连接器(`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` 运行 OAuth 流程。如果您更喜欢使用一个命令来同时安装和身份验证,或者需要本地文件或自托管模式,则上面的通用 CLI 路由也适用于 Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`)。
|
|
253
253
|
|
|
254
254
|
> **较旧的安装:**如果您的配置仍然有一个 `agent-native-plans` 条目指向相同的 URL,为 Codex 运行 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`,或者与您的目标 `--client` 运行相同的命令,则将其合并为规范的 `plan` 名称。
|
|
255
255
|
|
|
@@ -265,7 +265,7 @@ export default runMigrations(
|
|
|
265
265
|
| `/_agent-native/extensions/*` | 运行时扩展和扩展代理(旧别名:`/_agent-native/tools/*`) |
|
|
266
266
|
| `/_agent-native/integrations/*` | 消息传递/webhook 集成 |
|
|
267
267
|
| `/_agent-native/a2a` | 代理到代理 JSON-RPC |
|
|
268
|
-
| `/
|
|
268
|
+
| `/mcp` | MCP端点 |
|
|
269
269
|
| `/_agent-native/onboarding/*` | 设置清单 |
|
|
270
270
|
| `/_agent-native/observability/*` | 跟踪、反馈、评估、实验 |
|
|
271
271
|
| `/_agent-native/file-upload` | 文件上传提供程序端点 |
|
|
@@ -460,4 +460,4 @@ const handler = createProductionAgentHandler({
|
|
|
460
460
|
- [**数据库**](/docs/database) — 自定义路由和 actions 都会导入的 `getDb()`/`schema` 模式
|
|
461
461
|
- [**安全**](/docs/security#access-guards) — `accessFilter`/`assertAccess` 和完整的数据作用域模型
|
|
462
462
|
- [**消息传递**](/docs/messaging) — 入站 webhook 的标准集成队列模式
|
|
463
|
-
- [**MCP 协议**](/docs/mcp-protocol) — 此服务器自动挂载的 `/
|
|
463
|
+
- [**MCP 协议**](/docs/mcp-protocol) — 此服务器自动挂载的 `/mcp` 端点
|
|
@@ -313,7 +313,7 @@ scope: dev
|
|
|
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": [
|
|
@@ -123,7 +123,7 @@ Dispatch 是**工作区控制平面**。其他模板是域应用程序(邮件
|
|
|
123
123
|
在不复制原始机密的情况下分派访问权限。应用程序特定源
|
|
124
124
|
配置保留在使用提供程序的应用程序中。
|
|
125
125
|
- **暴露一个 MCP 连接器。**添加
|
|
126
|
-
`https://dispatch.agent-native.com/
|
|
126
|
+
`https://dispatch.agent-native.com/mcp`,Claude、ChatGPT,
|
|
127
127
|
Codex、Cursor 或其他 MCP 主机,然后选择要运行的工作区应用
|
|
128
128
|
连接器可以从 Dispatch 的 **代理** 页面进行访问。使用直接应用程序URL
|
|
129
129
|
仅当该主机应与一个应用隔离时。
|
|
@@ -304,7 +304,7 @@ _它的底层工作原理(对于开发人员)。_
|
|
|
304
304
|
]}
|
|
305
305
|
/>
|
|
306
306
|
|
|
307
|
-
- **MCP 集线器模式。** Dispatch 仍然可以充当工作区的 [MCP hub](/docs/mcp-clients#hub),因此工作区中的每个其他应用程序都会拉取相同的组织范围 MCP 服务器列表。另外,对于 Claude、ChatGPT 和其他应访问多个工作区应用的主机,Dispatch 自己的 `/
|
|
307
|
+
- **MCP 集线器模式。** Dispatch 仍然可以充当工作区的 [MCP hub](/docs/mcp-clients#hub),因此工作区中的每个其他应用程序都会拉取相同的组织范围 MCP 服务器列表。另外,对于 Claude、ChatGPT 和其他应访问多个工作区应用的主机,Dispatch 自己的 `/mcp` 端点是推荐的外部 MCP 连接器。
|
|
308
308
|
|
|
309
309
|
## 梦想 {#dreams}
|
|
310
310
|
|
|
@@ -110,7 +110,7 @@ npx @agent-native/core@latest skills add visual-plan
|
|
|
110
110
|
|
|
111
111
|
如果您使用的是直接接受 MCP 连接器 URL 的基于聊天的主机
|
|
112
112
|
(而不是 CLI 配置的客户端),连接托管计划连接器
|
|
113
|
-
`https://plan.agent-native.com/
|
|
113
|
+
`https://plan.agent-native.com/mcp` — 请参阅 [MCP Clients](/docs/mcp-clients) 以了解特定于客户端的设置。
|
|
114
114
|
|
|
115
115
|
身份验证是在设置时进行一次性浏览器登录 - 这是有意为之的
|
|
116
116
|
是让代理持续存在并共享其生成的计划的原因。授权是什么
|
|
@@ -249,7 +249,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
|
|
|
249
249
|
跨设备或团队审核)需要登录。Google 登录会在以下情况出现
|
|
250
250
|
标准 Google OAuth 环境变量已配置。
|
|
251
251
|
|
|
252
|
-
托管计划连接器位于 `https://plan.agent-native.com/
|
|
252
|
+
托管计划连接器位于 `https://plan.agent-native.com/mcp`。
|
|
253
253
|
切勿将共享机密放入技能文件中。
|
|
254
254
|
|
|
255
255
|
## 本地文件隐私模式 {#local-files}
|
|
@@ -447,7 +447,7 @@ pnpm dev
|
|
|
447
447
|
托管应用程序支持的技能使用:
|
|
448
448
|
|
|
449
449
|
- 应用程序:`https://plan.agent-native.com`
|
|
450
|
-
- MCP: `https://plan.agent-native.com/
|
|
450
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
451
451
|
|
|
452
452
|
当您开发计划本身、测试本地持久性或运行完全自托管的审核界面时,本地模板非常有用。
|
|
453
453
|
|
|
@@ -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` 在公開介面上選取安全讀取/攝取工具。請參閱 [MCP Protocol](/docs/mcp-protocol) 了解目錄層、驗證和 `mcpApp` 資源詳細資訊。
|
|
540
540
|
|
|
541
541
|
對於支援 UI 的 MCP 主機,操作可以透過 `mcpApp` 欄位(加上匹配的 `link`)聲明可選的 MCP Apps 資源,以便有能力的主機行內渲染結果。當 `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 @@ Dispatch 自動發現工作區中的其他應用程式作為 A2A 對等體 - 無
|
|
|
113
113
|
|
|
114
114
|
### 統一 MCP 閘道
|
|
115
115
|
|
|
116
|
-
Dispatch 可以是外部代理的單一 MCP 連線器:在 Claude、ChatGPT、Codex 或 Cursor 中新增一次 `https://dispatch.agent-native.com/
|
|
116
|
+
Dispatch 可以是外部代理的單一 MCP 連線器:在 Claude、ChatGPT、Codex 或 Cursor 中新增一次 `https://dispatch.agent-native.com/mcp`,一次授權可到達每個授予的工作區應用程式,而不是每個應用程式一個連線器。請參閱 [External Agents](/docs/external-agents) 了解完整的連線流程、應用程式授權、OAuth 和行內 MCP 應用程式預覽。
|
|
117
117
|
|
|
118
|
-
<Endpoint id="doc-block-1ht5rye" method="POST" path="/
|
|
118
|
+
<Endpoint id="doc-block-1ht5rye" 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 Cowork MCP 應用
|
|
|
98
98
|
對於工作區或跨應用程式工作,請使用 Dispatch:
|
|
99
99
|
|
|
100
100
|
```text
|
|
101
|
-
https://dispatch.agent-native.com/
|
|
101
|
+
https://dispatch.agent-native.com/mcp
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
Dispatch 是郵件、行事曆、分析、Brain 和您的單一閘道
|
|
@@ -109,12 +109,12 @@ Dispatch 是郵件、行事曆、分析、Brain 和您的單一閘道
|
|
|
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` 尋找給定主機和選定用戶端的 URL 以 `/
|
|
240
|
+
`reconnect` 尋找給定主機和選定用戶端的 URL 以 `/mcp` 結尾的任何 MCP 設定條目(透過 URL 進行匹配,無論連線器名稱如何),然後重新整理或替換驗證材料,而無需觸及已安裝的 skills 或重新執行完整安裝流程。傳遞基本應用程式 URL(例如 `https://plan.agent-native.com`) - 推斷出 `/mcp` 後綴。驗證和工具載入是針對每個用戶端的,因此之後重新啟動/重新載入該用戶端; Codex 在新載入的工具出現之前需要一個新工作階段。
|
|
241
241
|
|
|
242
242
|
在 Claude 程式碼中,等效的 UI 路徑是:執行`/mcp`並為相關連線器選取**驗證**(或**重新連線**)。
|
|
243
243
|
|
|
@@ -245,7 +245,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
|
|
|
245
245
|
|
|
246
246
|
### 連線頁面後備 {#connect-page-fallback}
|
|
247
247
|
|
|
248
|
-
對於無法直接新增遠端 OAuth URL 的 MCP 用戶端,請在瀏覽器中開啟應用程式並使用其 **Connect** 功能(在 `https://<app>/
|
|
248
|
+
對於無法直接新增遠端 OAuth URL 的 MCP 用戶端,請在瀏覽器中開啟應用程式並使用其 **Connect** 功能(在 `https://<app>/mcp/connect` 上提供)。登入後,點選“**連線/授權**”。該頁面為您提供一個設定偵測到的代理的一鍵深層連結,或一個可立即貼上的 `.mcp.json` 塊:
|
|
249
249
|
|
|
250
250
|
```jsonc
|
|
251
251
|
// .mcp.json
|
|
@@ -253,7 +253,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
|
|
|
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 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
|
|
|
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
|
這與 `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` 為您編寫的僅 URL 條目相同。然後在 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 連線來調解呼叫。
|
|
@@ -499,13 +499,13 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
|
|
|
499
499
|
|
|
500
500
|
在每個操作工具之上,MCP 伺服器公開了一個穩定的動詞集,因此外部代理具有可預測的表面,而無需猜測每個應用操作名稱:
|
|
501
501
|
|
|
502
|
-
| 工具 | 副作用 | 退貨
|
|
503
|
-
| -------------------------------------------------- | -------- |
|
|
504
|
-
| `list_apps` | 無 | 工作區應用+其 URL/執行狀態
|
|
505
|
-
| `open_app({ app, view?, path?, params?, embed? })` | 無 | 深層連結或同來源路由; `embed: true` 在支援的情況下行內渲染完整的應用程式
|
|
506
|
-
| `ask_app({ app, message })`
|
|
507
|
-
| `create_workspace_app({ name, template })` | 腳手架 | 透過工作區路徑啟動的新應用程式,及其正在執行的 URL + 深層連結
|
|
508
|
-
| `list_templates` | 無 | 僅限允許列出的範本
|
|
502
|
+
| 工具 | 副作用 | 退貨 |
|
|
503
|
+
| -------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
|
|
504
|
+
| `list_apps` | 無 | 工作區應用+其 URL/執行狀態 |
|
|
505
|
+
| `open_app({ app, view?, path?, params?, embed? })` | 無 | 深層連結或同來源路由; `embed: true` 在支援的情況下行內渲染完整的應用程式 |
|
|
506
|
+
| `ask_app({ app, message, async?, maxWaitMs? })` | 代理迴圈 | 將自然語言工作路由到該應用的應用內代理;長時間的工作會傳回持久的 `taskId`,供 `ask_app_status` 輪詢 |
|
|
507
|
+
| `create_workspace_app({ name, template })` | 腳手架 | 透過工作區路徑啟動的新應用程式,及其正在執行的 URL + 深層連結 |
|
|
508
|
+
| `list_templates` | 無 | 僅限允許列出的範本 |
|
|
509
509
|
|
|
510
510
|
`create_workspace_app` 拒絕任何非允許清單範本 - `packages/shared-app-config/templates.ts` 中的公開範本允許清單是權威且受 CI 保護的;外部代理無法擴大它。同名的範本操作會覆蓋內建操作(範本優先於核心優先級)。使用 `MCPConfig.builtinCrossAppTools: false` 停用整個設定。
|
|
511
511
|
|
|
@@ -513,6 +513,10 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
|
|
|
513
513
|
|
|
514
514
|
對於快速 ChatGPT/Claude 切換,理想的路徑是直接的:呼叫建立或開啟工件的操作,然後讓 MCP 應用程式啟動路由。郵件請求應呼叫 `manage_draft` 並呈現真實的撰寫路由。儀表板請求應呼叫 `open_app({ path, embed: true })` 或使用 `mcpApp` 的儀表板操作並呈現完整的 Analytics 路徑。行事曆、表單、內容、幻燈片、設計和剪輯的草稿/建立/搜尋 actions 應遵循相同的模式。當模型必須在授予的應用程式中進行選取時,`list_apps` 非常有用;廣泛的 `resources/list`、全目錄發現或 `ask_app` 委派不應該是明顯的 UI 切換的正常途徑。
|
|
515
515
|
|
|
516
|
+
### 長時間執行的代理請求
|
|
517
|
+
|
|
518
|
+
MCP 主機與閘道器並未共用單一的長工具呼叫逾時限制;有些強制五分鐘上限,有些則可設定。請勿將外部代理整合設計成依賴十分鐘的封鎖式 `tools/call`。`ask-agent` 與 `ask_app` 會快速確認託管工作,並在行內等待逾期時傳回持久的 `taskId`。請使用傳回的 `app` 與 `taskId` 呼叫 `ask_app_status` 進行輪詢;結果包含 `pollAfterMs` 作為對主機友善的輪詢間隔。任務必須在第一次回應逾時之前就已建立,因此僅在長時間呼叫後才傳回輪詢網址並非可靠的復原機制。
|
|
519
|
+
|
|
516
520
|
### 每應用游覽 {#tour}
|
|
517
521
|
|
|
518
522
|
每個生成或列出可導覽資源的允許清單範本都會附帶一個 `link` 建置器,而攝取量大的範本會附帶一個 GET + `publicAgent` 操作,以便連線的代理可以擷取即時狀態:
|
|
@@ -676,7 +680,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
|
|
|
676
680
|
- **cowork** — `~/.cowork/mcp.json` 中相同的 Claude 程式碼 JSON 形狀。
|
|
677
681
|
- **codex** — `~/.codex/config.toml` 中的 `[mcp_servers.<name>]` 區塊。
|
|
678
682
|
|
|
679
|
-
該條目執行 `npx @agent-native/core@latest mcp serve --app <id>`,預設情況下,它是正在執行的本機應用程式的 `/
|
|
683
|
+
該條目執行 `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`)時,它會寫入指向 `<origin>/mcp` 的 `http` 用戶端條目,並使用 `Bearer` JWT 而不是 stdio 條目。
|
|
680
684
|
|
|
681
685
|
配套子指令:
|
|
682
686
|
|
|
@@ -700,7 +704,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
|
|
|
700
704
|
"mcpServers": {
|
|
701
705
|
"analytics": {
|
|
702
706
|
"type": "http",
|
|
703
|
-
"url": "https://analytics.agent-native.com/
|
|
707
|
+
"url": "https://analytics.agent-native.com/mcp",
|
|
704
708
|
"headers": { "Authorization": "Bearer <ACCESS_TOKEN-or-JWT>" },
|
|
705
709
|
},
|
|
706
710
|
},
|
|
@@ -742,7 +746,7 @@ npx @agent-native/core@latest connect prod --apps mail,calendar,analytics --clie
|
|
|
742
746
|
後備託管的 `connect` 流永遠不會複製部署的共用金鑰。相反:
|
|
743
747
|
|
|
744
748
|
- 登入的瀏覽器工作階段會鑄造一個**每使用者、範圍內、可撤銷**權杖 - 一個 `A2A_SECRET` 簽名的 JWT,攜帶呼叫者的 `sub` + `org_domain` 和一個唯一的 `jti`,因此每個工具執行都透過 `runWithRequestContext` 保持租戶範圍。
|
|
745
|
-
- 現有的 `/
|
|
749
|
+
- 現有的 `/mcp` 端點像任何其他承載一樣接受該權杖(請參閱 [MCP Protocol](/docs/mcp-protocol)) - 沒有新端點,沒有新傳輸。
|
|
746
750
|
- 同一個 Connect 頁面列出了您鑄造的每個代幣,並允許您透過 `jti` **撤銷**其中任何代幣。將它們視為個人存取權杖:每個代理用戶端一個,在機器退役時撤銷。
|
|
747
751
|
- 代理返還的深層連結不帶有特權狀態。以紀錄為中心的 `navigate` 寫入始終限於 **瀏覽器** 工作階段,而不是代理的權杖 - 因此可以安全地將連結貼上到終端或聊天紀錄中。
|
|
748
752
|
|
|
@@ -245,6 +245,29 @@ MCP 工具僅在 Node 執行時啟用 - Cloudflare Workers 和其他邊緣
|
|
|
245
245
|
|
|
246
246
|
MCP(模型脈絡協議)伺服器為您的代理提供新的能力 - 例如連線到 Zapier、Cloudflare、Composio 或您公司的內部工具。連線後,代理可以像使用內建工具一樣使用這些工具。
|
|
247
247
|
|
|
248
|
+
預設 ID 包括 `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
|
|
255
|
+
工具。建立 Jira 議題需要具備允許寫入 Jira 的 Atlassian 權限;使用者仍然只能
|
|
256
|
+
看到其 Atlassian 帳戶有權存取的專案和內容。
|
|
257
|
+
|
|
258
|
+
Atlassian 組織管理員可以控制是否允許 OAuth 用戶端連線。連線之前,管理員可能
|
|
259
|
+
需要將應用程式的實際 HTTPS 來源新增至 **Atlassian Administration → Rovo →
|
|
260
|
+
Rovo MCP server → Domains** 下的受信任網域清單,並在 **Permissions** 中啟用
|
|
261
|
+
所需的 **Read**、**Write** 和 **Search** 權限。該網域必須是 Agent-Native
|
|
262
|
+
應用程式實際執行的主機;除非 `https://builder.io/**` 是部署的實際來源,否則
|
|
263
|
+
不要將其複製到其他部署。請參閱 Atlassian 的 [Rovo MCP 設定指南](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/)
|
|
264
|
+
和[管理員控制說明](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/)。
|
|
265
|
+
|
|
266
|
+
目錄會提供端點和設定指引。通用設定表單會儲存端點和選用的加密標頭,但無法取代
|
|
267
|
+
Atlassian 的互動式 OAuth 同意流程。當 Atlassian 要求互動式 OAuth 時,請使用
|
|
268
|
+
支援 OAuth 的 MCP 用戶端或執行階段。如果供應商或執行階段支援靜態 Bearer
|
|
269
|
+
權杖,請遵循其核准的密鑰管理流程,切勿將權杖貼到提示詞或已提交的設定中。
|
|
270
|
+
|
|
248
271
|
### 如何連線遠端 MCP 伺服器
|
|
249
272
|
|
|
250
273
|
1. **伺服器名稱** - 供您自己參考的簡短標籤(例如“zapier”、“slack-tools”)。
|
|
@@ -263,7 +286,7 @@ MCP(模型脈絡協議)伺服器為您的代理提供新的能力 - 例如
|
|
|
263
286
|
|
|
264
287
|
在正在執行的 MCP 管理器中新增和刪除熱重載 — 無需重新啟動行程,也無需重新啟動伺服器。新的 `mcp__<scope>-<name>__*` 工具將在下一條訊息中向代理顯示,並且可透過 `tool-search` 進行搜尋。
|
|
265
288
|
|
|
266
|
-
HTTPS URL 在任何地方都被接受; plain `http://` 在開發過程中僅允許用於 `localhost`。可選的驗證作為不記名權杖在每個請求上透過 `Authorization: Bearer …`
|
|
289
|
+
HTTPS URL 在任何地方都被接受; plain `http://` 在開發過程中僅允許用於 `localhost`。可選的驗證作為不記名權杖在每個請求上透過 `Authorization: Bearer …` 傳送。僅支援 OAuth 的供應商(包括 Atlassian Rovo MCP)必須使用供應商的 OAuth 流程,而不能使用靜態標頭。
|
|
267
290
|
|
|
268
291
|
在底層,這些伺服器以 `u:<email>:mcp-servers-remote`(個人)或 `o:<orgId>:mcp-servers-remote`(團隊)鍵儲存在框架的 `settings` 表中,並在啟動時與 `mcp.config.json` 合併。
|
|
269
292
|
|
|
@@ -292,7 +315,9 @@ Dispatch 是傳統的中心 - 它已經跨應用進行協調。
|
|
|
292
315
|
<div class="diagram-panel center" data-rough>
|
|
293
316
|
<span class="diagram-pill accent">Dispatch hub</span
|
|
294
317
|
><small class="diagram-muted">組織範圍 MCP 伺服器</small
|
|
295
|
-
><small class="diagram-muted"
|
|
318
|
+
><small class="diagram-muted"
|
|
319
|
+
><code>GET /_agent-native/mcp/hub/servers</code></small
|
|
320
|
+
>
|
|
296
321
|
</div>
|
|
297
322
|
<div class="diagram-col arrows">
|
|
298
323
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
@@ -454,7 +479,7 @@ Reports which configured servers connected, the total live tool count, the merge
|
|
|
454
479
|
|
|
455
480
|
個別 MCP 伺服器故障永遠不會導致代理關閉:
|
|
456
481
|
|
|
457
|
-
- 設定錯誤的 `command` → 伺服器被跳過,其錯誤出現在 `errors.<server-id>` 下的 `/mcp/status` 中,而其他所有伺服器繼續工作。
|
|
482
|
+
- 設定錯誤的 `command` → 伺服器被跳過,其錯誤出現在 `errors.<server-id>` 下的 `/_agent-native/mcp/status` 中,而其他所有伺服器繼續工作。
|
|
458
483
|
- `node_modules` 中缺少 MCP SDK → 所有 MCP 功能都會被跳過並出現警告;代理聊天可以使用零 MCP 工具繼續工作。
|
|
459
484
|
- 在邊緣執行時中執行 → MCP 用戶端是無操作的。
|
|
460
485
|
|
|
@@ -22,7 +22,7 @@ MCP 是用於將 AI 工具連線到外部功能的標準協議。當您部署 Ag
|
|
|
22
22
|
|
|
23
23
|
關鍵概念:
|
|
24
24
|
|
|
25
|
-
- **自動安裝** — 每個應用都免費獲得 `/
|
|
25
|
+
- **自動安裝** — 每個應用都免費獲得 `/mcp`,無需設定
|
|
26
26
|
- **Streamable HTTP** — 在標準 HTTP (POST + SSE) 上使用現代 MCP 傳輸
|
|
27
27
|
- **相同的 actions** — 為代理聊天和 A2A 提供支援的完全相同的操作註冊表
|
|
28
28
|
- **`ask-agent` 工具** — 一種元工具,可委托給完整代理迴圈來執行複雜工作
|
|
@@ -41,7 +41,7 @@ MCP 是用於將 AI 工具連線到外部功能的標準協議。當您部署 Ag
|
|
|
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 @@ MCP 是用於將 AI 工具連線到外部功能的標準協議。當您部署 Ag
|
|
|
94
94
|
| **最適合** | 呼叫您的應用的外部工具 | 代理間通信 |
|
|
95
95
|
| **協議** | MCP 可流式傳輸 HTTP | JSON-RPC 2.0 |
|
|
96
96
|
| **工具發現** | `tools/list` | `/.well-known/agent-card.json`的代理卡 |
|
|
97
|
-
| **端點** | `/
|
|
97
|
+
| **端點** | `/mcp` | `/_agent-native/a2a` |
|
|
98
98
|
| **支援** | Claude、ChatGPT、Claude Code、Cursor、Codex、Cowork 和其他 MCP 主機 | 其他 Agent-Native 應用 |
|
|
99
99
|
| **執行** | 直接工具呼叫(無需額外的 LLM) | 完整代理迴圈(LLM 推理) |
|
|
100
100
|
|
|
@@ -105,7 +105,7 @@ MCP 是用於將 AI 工具連線到外部功能的標準協議。當您部署 Ag
|
|
|
105
105
|
對於建議的單指令設定,請使用 [External Agents](/docs/external-agents)。如果您為支援 OAuth 的用戶端手寫 MCP 設定,請將您的應用新增為不帶靜態標頭的遠端 MCP 伺服器:
|
|
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
|
或者在 `.mcp.json`(專案範圍)或 `~/.claude.json`(使用者範圍)中手動寫入條目:
|
|
@@ -116,7 +116,7 @@ claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
|
|
|
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
|
任何支援 Streamable HTTP 傳輸的 MCP 用戶端都可以連線。端點是:
|
|
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
|
伺服器支援標準 MCP 握手:`initialize`→`initialized`→`tools/list`→`tools/call`。
|
|
142
142
|
|
|
143
|
-
<Endpoint id="doc-block-1qz0910" title={"MCP 端點"} summary={"每個 Agent-Native 應用程式都會公開自動安裝的 Streamable HTTP 端點。"} method="POST" path="/
|
|
143
|
+
<Endpoint id="doc-block-1qz0910" title={"MCP 端點"} summary={"每個 Agent-Native 應用程式都會公開自動安裝的 Streamable HTTP 端點。"} method="POST" path="/mcp" summary={"MCP 可流式 HTTP 端點"} 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,33 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
|
|
|
204
204
|
|
|
205
205
|
除了單獨的操作工具外,每個 MCP 伺服器還包含一個 `ask-agent` 元工具。這會向應用程式的 AI 代理傳送一條自然語言訊息並返回回應。
|
|
206
206
|
|
|
207
|
+
託管 MCP 請求使用有上限的行內等待,讓長時間執行的代理迴圈不會讓單一 `tools/call` 一直開啟,直到用戶端或閘道器逾時為止。選用的 `async` 參數會啟動持久任務並立即返回;若未提供,伺服器會短暫等待快速完成,若仍有工作待處理,則會返回任務控點。託管等待上限為 25 秒。
|
|
208
|
+
|
|
207
209
|
使用 `ask-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
|
+
代理執行與互動式聊天相同的迴圈 — 它可以呼叫多個工具、推理脈絡並生成深思熟慮的回應。尚未完成的任務會返回包含 `taskId`、`status`、`pollAfterMs` 的 JSON,以及:
|
|
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
|
+
請使用這些引數呼叫 `ask_app_status`,直到任務進入終止狀態。Dispatch 應用程式自有的
|
|
233
|
+
`ask_app` 使用相同的持久任務與狀態合約,並在提交與輪詢時都會檢查所選應用程式的授權。
|
|
219
234
|
|
|
220
235
|
## 驗證 {#authentication}
|
|
221
236
|
|
|
@@ -233,7 +248,7 @@ MCP 端點支援標準遠端 MCP OAuth 以及現有的不記名權杖後備:
|
|
|
233
248
|
對於支援 OAuth 的 MCP 主機,設定不帶靜態標頭的遠端伺服器 URL:
|
|
234
249
|
|
|
235
250
|
```bash
|
|
236
|
-
claude mcp add --transport http agent-native https://dispatch.agent-native.com/
|
|
251
|
+
claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
|
|
237
252
|
```
|
|
238
253
|
|
|
239
254
|
第一個未經驗證的 MCP 請求收到:
|
|
@@ -249,9 +264,9 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
|
|
|
249
264
|
| ----------------------------------------- | ---------------------------- |
|
|
250
265
|
| `/.well-known/oauth-protected-resource` | RFC 9728 受保護資源中繼資料 |
|
|
251
266
|
| `/.well-known/oauth-authorization-server` | OAuth 授權伺服器中繼資料 |
|
|
252
|
-
| `/
|
|
253
|
-
| `/
|
|
254
|
-
| `/
|
|
267
|
+
| `/mcp/oauth/register` | 動態公開用戶端註冊 |
|
|
268
|
+
| `/mcp/oauth/authorize` | 瀏覽器授權+同意 |
|
|
269
|
+
| `/mcp/oauth/token` | 授權程式碼和重新整理權杖授予 |
|
|
255
270
|
|
|
256
271
|
<Diagram id="doc-block-cy0fgf" title={"OAuth 發現流程"} summary={"401 啟動發現、註冊和 PKCE 授權 → 權杖交換。不記名權杖是受受眾限制和範圍的。"}>
|
|
257
272
|
|
|
@@ -351,7 +366,7 @@ export default defineNitroPlugin(async (nitro) => {
|
|
|
351
366
|
您在 `analytics.example.com` 部署了分析應用程式。來自 Claude 程式碼:
|
|
352
367
|
|
|
353
368
|
```bash
|
|
354
|
-
claude mcp add --transport http analytics https://analytics.example.com/
|
|
369
|
+
claude mcp add --transport http analytics https://analytics.example.com/mcp
|
|
355
370
|
```
|
|
356
371
|
|
|
357
372
|
或者在`.mcp.json`中手動新增:
|
|
@@ -362,7 +377,7 @@ claude mcp add --transport http analytics https://analytics.example.com/_agent-n
|
|
|
362
377
|
"mcpServers": {
|
|
363
378
|
"analytics": {
|
|
364
379
|
"type": "http",
|
|
365
|
-
"url": "https://analytics.example.com/
|
|
380
|
+
"url": "https://analytics.example.com/mcp",
|
|
366
381
|
},
|
|
367
382
|
},
|
|
368
383
|
}
|
|
@@ -12,7 +12,7 @@ Agent-Native **Plan** 應用程式以一個可安裝的 bundle 提供。一次
|
|
|
12
12
|
一次安裝即可為您提供:
|
|
13
13
|
|
|
14
14
|
- **三個 skills** — `/visual-plan`(規範入口點)、`/visual-recap` 和 `/visualize-repo`。
|
|
15
|
-
- **計畫 MCP 連線器** — 針對 `https://plan.agent-native.com` 上的託管應用程式進行註冊(MCP 端點 `https://plan.agent-native.com/
|
|
15
|
+
- **計畫 MCP 連線器** — 針對 `https://plan.agent-native.com` 上的託管應用程式進行註冊(MCP 端點 `https://plan.agent-native.com/mcp`,伺服器名稱 `plan`)。
|
|
16
16
|
|
|
17
17
|
<Diagram id="doc-block-6n3so7" title={"三條路由,一攬子"} summary={"通用 CLI、Claude Code 外掛和 Codex 外掛都會安裝同一組 Plan skills 以及託管的 Plan 連線器。"}>
|
|
18
18
|
|
|
@@ -41,7 +41,7 @@ Agent-Native **Plan** 應用程式以一個可安裝的 bundle 提供。一次
|
|
|
41
41
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
42
42
|
<div class="diagram-box">
|
|
43
43
|
Plan MCP connector<br /><small class="diagram-muted"
|
|
44
|
-
>plan.agent-native.com/
|
|
44
|
+
>plan.agent-native.com/mcp</small
|
|
45
45
|
>
|
|
46
46
|
</div>
|
|
47
47
|
</div>
|
|
@@ -249,7 +249,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
|
|
|
249
249
|
codex mcp login plan # 瀏覽器中的 OAuth
|
|
250
250
|
```
|
|
251
251
|
|
|
252
|
-
安裝後,**啟動新的 Codex 對話串**,以便 skills 和 MCP 工具載入到工作階段中。該外掛附帶一個僅限 URL 的連線器(`[mcp_servers.plan]` → `https://plan.agent-native.com/
|
|
252
|
+
安裝後,**啟動新的 Codex 對話串**,以便 skills 和 MCP 工具載入到工作階段中。該外掛附帶一個僅限 URL 的連線器(`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` 執行 OAuth 流程。如果您更喜歡使用一個指令來同時安裝和驗證,或者需要本機檔案或自託管模式,則上面的通用 CLI 路由也適用於 Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`)。
|
|
253
253
|
|
|
254
254
|
> **較舊的安裝:**如果您的設定仍然有一個 `agent-native-plans` 條目指向相同的 URL,為 Codex 執行 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`,或者與您的目標 `--client` 執行相同的指令,則將其合併為規範的 `plan` 名稱。
|
|
255
255
|
|
|
@@ -265,7 +265,7 @@ export default runMigrations(
|
|
|
265
265
|
| `/_agent-native/extensions/*` | 執行時擴充功能和擴充功能代理(舊別名:`/_agent-native/tools/*`) |
|
|
266
266
|
| `/_agent-native/integrations/*` | 訊息傳遞/webhook 整合 |
|
|
267
267
|
| `/_agent-native/a2a` | 代理到代理 JSON-RPC |
|
|
268
|
-
| `/
|
|
268
|
+
| `/mcp` | MCP 端點 |
|
|
269
269
|
| `/_agent-native/onboarding/*` | 設定清單 |
|
|
270
270
|
| `/_agent-native/observability/*` | 跟蹤、意見回饋、評估、實驗 |
|
|
271
271
|
| `/_agent-native/file-upload` | 檔案上傳提供者端點 |
|
|
@@ -460,4 +460,4 @@ const handler = createProductionAgentHandler({
|
|
|
460
460
|
- [**資料庫**](/docs/database) — 自訂路由和 actions 都會匯入的 `getDb()`/`schema` 模式
|
|
461
461
|
- [**安全性**](/docs/security#access-guards) — `accessFilter`/`assertAccess` 和完整的資料範圍模型
|
|
462
462
|
- [**訊息傳遞**](/docs/messaging) — 傳入 webhook 的標準整合佇列模式
|
|
463
|
-
- [**MCP 通訊協定**](/docs/mcp-protocol) — 此伺服器自動掛載的 `/
|
|
463
|
+
- [**MCP 通訊協定**](/docs/mcp-protocol) — 此伺服器自動掛載的 `/mcp` 端點
|
|
@@ -313,7 +313,7 @@ Agent-Native 執行時從 `.agents/skills/` 讀取 skills。 Claude 程式碼獨
|
|
|
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": [
|
|
@@ -487,7 +487,7 @@ Codex、Claude 程式碼和 Claude 桌面程式碼應被視為連結輸出主機
|
|
|
487
487
|
### 開發者:分發應用技能
|
|
488
488
|
|
|
489
489
|
資產應用技能的應用 ID為 `assets` 並託管 MCP URL
|
|
490
|
-
`https://assets.agent-native.com/
|
|
490
|
+
`https://assets.agent-native.com/mcp`.
|
|
491
491
|
|
|
492
492
|
```bash
|
|
493
493
|
# 最簡單的託管安裝:匯出的技能說明加上 MCP 連線器。
|
|
@@ -123,7 +123,7 @@ Dispatch 是**工作區控制平面**。其他範本是域應用程式(郵件
|
|
|
123
123
|
在不複製原始機密的情況下分派存取權限。應用程式特定來源
|
|
124
124
|
設定保留在使用提供者的應用程式中。
|
|
125
125
|
- **暴露一個 MCP 連線器。**新增
|
|
126
|
-
`https://dispatch.agent-native.com/
|
|
126
|
+
`https://dispatch.agent-native.com/mcp`,Claude、ChatGPT,
|
|
127
127
|
Codex、Cursor 或其他 MCP 主機,然後選取要執行的工作區應用
|
|
128
128
|
連線器可以從 Dispatch 的 **代理** 頁面進行存取。使用直接應用程式 URL
|
|
129
129
|
僅當該主機應與一個應用隔離時。
|
|
@@ -304,7 +304,7 @@ _它的底層工作原理(對於開發人員)。_
|
|
|
304
304
|
]}
|
|
305
305
|
/>
|
|
306
306
|
|
|
307
|
-
- **MCP 集線器模式。** Dispatch 仍然可以充當工作區的 [MCP hub](/docs/mcp-clients#hub),因此工作區中的每個其他應用程式都會拉取相同的組織範圍 MCP 伺服器清單。另外,對於 Claude、ChatGPT 和其他應存取多個工作區應用的主機,Dispatch 自己的 `/
|
|
307
|
+
- **MCP 集線器模式。** Dispatch 仍然可以充當工作區的 [MCP hub](/docs/mcp-clients#hub),因此工作區中的每個其他應用程式都會拉取相同的組織範圍 MCP 伺服器清單。另外,對於 Claude、ChatGPT 和其他應存取多個工作區應用的主機,Dispatch 自己的 `/mcp` 端點是推薦的外部 MCP 連線器。
|
|
308
308
|
|
|
309
309
|
## 夢想 {#dreams}
|
|
310
310
|
|
|
@@ -110,7 +110,7 @@ npx @agent-native/core@latest skills add visual-plan
|
|
|
110
110
|
|
|
111
111
|
如果您使用的是直接接受 MCP 連線器 URL 的基於聊天的主機
|
|
112
112
|
(而不是 CLI 設定的用戶端),連線託管計畫連線器
|
|
113
|
-
`https://plan.agent-native.com/
|
|
113
|
+
`https://plan.agent-native.com/mcp` — 請參閱 [MCP Clients](/docs/mcp-clients) 以了解特定於用戶端的設定。
|
|
114
114
|
|
|
115
115
|
驗證是在設定時進行一次性瀏覽器登入 - 這是有意為之的
|
|
116
116
|
是讓代理持續存在並共用其產生的計畫的原因。授權是什麼
|
|
@@ -249,7 +249,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
|
|
|
249
249
|
跨設備或團隊審核)需要登入。Google 登入會在以下情況出現
|
|
250
250
|
標準 Google OAuth 環境變數已設定。
|
|
251
251
|
|
|
252
|
-
託管計畫連線器位於 `https://plan.agent-native.com/
|
|
252
|
+
託管計畫連線器位於 `https://plan.agent-native.com/mcp`。
|
|
253
253
|
切勿將共用機密放入技能檔案中。
|
|
254
254
|
|
|
255
255
|
## 本機檔案隱私模式 {#local-files}
|
|
@@ -447,7 +447,7 @@ pnpm dev
|
|
|
447
447
|
託管應用程式支援的技能使用:
|
|
448
448
|
|
|
449
449
|
- 應用程式:`https://plan.agent-native.com`
|
|
450
|
-
- MCP: `https://plan.agent-native.com/
|
|
450
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
451
451
|
|
|
452
452
|
當您開發計畫本身、測試本機持久性或執行完全自託管的審核介面時,本機範本非常有用。
|
|
453
453
|
|