@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 é o protocolo padrão para conectar ferramentas de IA a recursos externos.
|
|
|
22
22
|
|
|
23
23
|
Conceitos principais:
|
|
24
24
|
|
|
25
|
-
- **Montado automaticamente** — todos os aplicativos recebem `/
|
|
25
|
+
- **Montado automaticamente** — todos os aplicativos recebem `/mcp` gratuitamente, sem necessidade de configuração
|
|
26
26
|
- **Streamable HTTP** — usa o transporte MCP moderno sobre o HTTP padrão (POST + SSE)
|
|
27
27
|
- **Mesmo actions** — exatamente o mesmo registro de ação que alimenta o chat do agente e o A2A
|
|
28
28
|
- **Ferramenta `ask-agent`** — uma metaferramenta que delega tarefas complexas ao loop completo do agente
|
|
@@ -41,7 +41,7 @@ Conceitos principais:
|
|
|
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 @@ Ambos os protocolos são montados automaticamente. Use o que for mais adequado a
|
|
|
94
94
|
| **Melhor para** | Ferramentas externas que chamam seu aplicativo | Comunicação entre agentes |
|
|
95
95
|
| **Protocolo** | MCP HTTP transmitível | JSON-RPC 2.0 |
|
|
96
96
|
| **Descoberta de ferramentas** | `tools/list` | Cartão de agente em `/.well-known/agent-card.json` |
|
|
97
|
-
| **Ponto final** | `/
|
|
97
|
+
| **Ponto final** | `/mcp` | `/_agent-native/a2a` |
|
|
98
98
|
| **Apoiado por** | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork e outros hosts MCP | Outros aplicativos nativos do agente |
|
|
99
99
|
| **Execução** | Chamadas diretas de ferramenta (sem LLM extra) | Loop completo do agente (raciocínio LLM) |
|
|
100
100
|
|
|
@@ -105,7 +105,7 @@ Você também pode usar a ferramenta `ask-agent` MCP para obter o melhor dos doi
|
|
|
105
105
|
Para a configuração recomendada de um comando, use [External Agents](/docs/external-agents). Se você estiver escrevendo à mão a configuração MCP para um cliente compatível com OAuth, adicione seu aplicativo como um servidor MCP remoto sem cabeçalhos estáticos:
|
|
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 escreva a entrada manualmente em `.mcp.json` (escopo do projeto) ou `~/.claude.json` (escopo do usuário):
|
|
@@ -116,7 +116,7 @@ Ou escreva a entrada manualmente em `.mcp.json` (escopo do projeto) ou `~/.claud
|
|
|
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
|
Qualquer cliente MCP que suporte o transporte Streamable HTTP pode se conectar. O ponto final é:
|
|
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
|
O servidor suporta o handshake MCP padrão: `initialize` → `initialized` → `tools/list` → `tools/call`.
|
|
142
142
|
|
|
143
|
-
<Endpoint id="doc-block-1vujp7k" title="MCP ponto final" summary={"O endpoint Streamable HTTP montado automaticamente que todo aplicativo nativo do agente expõe."} method="POST" path="/
|
|
143
|
+
<Endpoint id="doc-block-1vujp7k" title="MCP ponto final" summary={"O endpoint Streamable HTTP montado automaticamente que todo aplicativo nativo do agente expõe."} method="POST" path="/mcp" summary={"MCP Endpoint HTTP transmitível"} 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,35 @@ Quando `mcpApp` está presente, a entrada da ferramenta também inclui `_meta.ui
|
|
|
204
204
|
|
|
205
205
|
Além das ferramentas de ação individuais, cada servidor MCP inclui uma meta-ferramenta `ask-agent`. Isso envia uma mensagem em linguagem natural ao agente de IA do aplicativo e retorna a resposta.
|
|
206
206
|
|
|
207
|
+
As solicitações MCP hospedadas usam uma espera embutida limitada para que um loop de agente longo não mantenha um `tools/call` aberto até um timeout do cliente ou do gateway. O argumento opcional `async` inicia a tarefa durável e retorna imediatamente; sem ele, o servidor aguarda brevemente por uma conclusão rápida e depois retorna um identificador de tarefa quando ainda resta trabalho. A espera hospedada tem um limite de 25 segundos.
|
|
208
|
+
|
|
207
209
|
Use `ask-agent` para tarefas complexas que se beneficiam do raciocínio e do contexto do agente:
|
|
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
|
+
O agente executa o mesmo loop que o bate-papo interativo: ele pode chamar diversas ferramentas, raciocinar sobre o contexto e produzir uma resposta cuidadosa. Uma tarefa que ainda não terminou retorna um JSON contendo `taskId`, `status`, `pollAfterMs` e:
|
|
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
|
+
Chame `ask_app_status` com esses argumentos até que a tarefa alcance um estado
|
|
233
|
+
terminal. O `ask_app` de propriedade do aplicativo no Dispatch usa o mesmo
|
|
234
|
+
contrato de tarefa durável e status, com a concessão do aplicativo selecionado
|
|
235
|
+
verificada tanto no envio quanto na consulta.
|
|
219
236
|
|
|
220
237
|
## Autenticação {#authentication}
|
|
221
238
|
|
|
@@ -233,7 +250,7 @@ O endpoint MCP suporta MCP remoto padrão OAuth mais o substituto de token de po
|
|
|
233
250
|
Para hosts MCP compatíveis com OAuth, configure o servidor remoto URL sem cabeçalhos estáticos:
|
|
234
251
|
|
|
235
252
|
```bash
|
|
236
|
-
claude mcp add --transport http agent-native https://dispatch.agent-native.com/
|
|
253
|
+
claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
|
|
237
254
|
```
|
|
238
255
|
|
|
239
256
|
A primeira solicitação MCP não autenticada recebe:
|
|
@@ -249,9 +266,9 @@ Endpoints de descoberta:
|
|
|
249
266
|
| ----------------------------------------- | ---------------------------------------------------------- |
|
|
250
267
|
| `/.well-known/oauth-protected-resource` | Metadados de recursos protegidos RFC 9728 |
|
|
251
268
|
| `/.well-known/oauth-authorization-server` | Metadados do servidor de autorização OAuth |
|
|
252
|
-
| `/
|
|
253
|
-
| `/
|
|
254
|
-
| `/
|
|
269
|
+
| `/mcp/oauth/register` | Registro dinâmico de cliente público |
|
|
270
|
+
| `/mcp/oauth/authorize` | Autorização + consentimento do navegador |
|
|
271
|
+
| `/mcp/oauth/token` | Concessões de código de autorização e token de atualização |
|
|
255
272
|
|
|
256
273
|
<Diagram id="doc-block-yoa2u7" title="Fluxo de descoberta OAuth" summary={"Um 401 inicia a descoberta, o registro e uma autorização PKCE → troca de tokens. O token Bearer é vinculado ao público e tem escopo definido."}>
|
|
257
274
|
|
|
@@ -351,7 +368,7 @@ export default defineNitroPlugin(async (nitro) => {
|
|
|
351
368
|
Você tem um aplicativo de análise implantado em `analytics.example.com`. Do código Claude:
|
|
352
369
|
|
|
353
370
|
```bash
|
|
354
|
-
claude mcp add --transport http analytics https://analytics.example.com/
|
|
371
|
+
claude mcp add --transport http analytics https://analytics.example.com/mcp
|
|
355
372
|
```
|
|
356
373
|
|
|
357
374
|
Ou adicione manualmente em `.mcp.json`:
|
|
@@ -362,7 +379,7 @@ Ou adicione manualmente em `.mcp.json`:
|
|
|
362
379
|
"mcpServers": {
|
|
363
380
|
"analytics": {
|
|
364
381
|
"type": "http",
|
|
365
|
-
"url": "https://analytics.example.com/
|
|
382
|
+
"url": "https://analytics.example.com/mcp",
|
|
366
383
|
},
|
|
367
384
|
},
|
|
368
385
|
}
|
|
@@ -12,7 +12,7 @@ O aplicativo Agent-Native **Plan** é enviado como um pacote instalável. Uma ú
|
|
|
12
12
|
Uma instalação oferece:
|
|
13
13
|
|
|
14
14
|
- **Três skills** — `/visual-plan` (o ponto de entrada canônico), `/visual-recap` e `/visualize-repo`.
|
|
15
|
-
- **O conector do Plano MCP** — registrado no aplicativo hospedado em `https://plan.agent-native.com` (endpoint MCP `https://plan.agent-native.com/
|
|
15
|
+
- **O conector do Plano MCP** — registrado no aplicativo hospedado em `https://plan.agent-native.com` (endpoint MCP `https://plan.agent-native.com/mcp`, nome do servidor `plan`).
|
|
16
16
|
|
|
17
17
|
<Diagram id="doc-block-1uxomn4" title={"Três rotas, um pacote"} summary={"O CLI universal, o plug-in Claude Code e o plug-in Codex instalam as mesmas skills do Plan mais o conector do Plan hospedado."}>
|
|
18
18
|
|
|
@@ -43,7 +43,7 @@ Uma instalação oferece:
|
|
|
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 no navegador
|
|
252
252
|
```
|
|
253
253
|
|
|
254
|
-
Após a instalação, **inicie um novo thread Codex** para que as ferramentas skills e MCP sejam carregadas na sessão. O plugin vem com um conector somente URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/
|
|
254
|
+
Após a instalação, **inicie um novo thread Codex** para que as ferramentas skills e MCP sejam carregadas na sessão. O plugin vem com um conector somente URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` executa o fluxo OAuth. A rota universal CLI acima também funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) se você preferir um comando que instale e autentique juntos ou quando desejar arquivos locais ou modo auto-hospedado.
|
|
255
255
|
|
|
256
256
|
> **Instalações mais antigas:** se sua configuração ainda tiver uma entrada `agent-native-plans` apontando para o mesmo URL, executando `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` para Codex ou o mesmo comando com seu `--client` de destino, consolida-o no nome canônico `plan`.
|
|
257
257
|
|
|
@@ -269,7 +269,7 @@ A estrutura monta suas próprias rotas em `/_agent-native/`. Trate esse namespac
|
|
|
269
269
|
| `/_agent-native/extensions/*` | Extensões de tempo de execução e proxy de extensão (alias legado: `/_agent-native/tools/*`) |
|
|
270
270
|
| `/_agent-native/integrations/*` | Integrações de mensagens/webhook |
|
|
271
271
|
| `/_agent-native/a2a` | Agente para agente JSON-RPC |
|
|
272
|
-
| `/
|
|
272
|
+
| `/mcp` | Ponto final MCP |
|
|
273
273
|
| `/_agent-native/onboarding/*` | Lista de verificação de configuração |
|
|
274
274
|
| `/_agent-native/observability/*` | Traces, feedback, avaliações, experimentos |
|
|
275
275
|
| `/_agent-native/file-upload` | Endpoint do provedor de upload de arquivos |
|
|
@@ -465,4 +465,4 @@ const handler = createProductionAgentHandler({
|
|
|
465
465
|
- [**Banco de dados**](/docs/database) — o padrão `getDb()`/`schema` importado por rotas personalizadas e actions
|
|
466
466
|
- [**Segurança**](/docs/security#access-guards) — `accessFilter`/`assertAccess` e o modelo completo de escopo de dados
|
|
467
467
|
- [**Mensagens**](/docs/messaging) — o padrão canônico de fila de integração para webhooks recebidos
|
|
468
|
-
- [**Protocolo MCP**](/docs/mcp-protocol) — o endpoint `/
|
|
468
|
+
- [**Protocolo MCP**](/docs/mcp-protocol) — o endpoint `/mcp` que este servidor monta automaticamente
|
|
@@ -313,7 +313,7 @@ Cada habilidade apoiada pelo aplicativo começa com `agent-native.app-skill.json
|
|
|
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": [
|
|
@@ -493,7 +493,7 @@ selecionador humano UI.
|
|
|
493
493
|
### Desenvolvedor: distribua a habilidade do aplicativo
|
|
494
494
|
|
|
495
495
|
A habilidade do aplicativo Assets tem o ID do aplicativo `assets` e MCP hospedado URL hospedado
|
|
496
|
-
`https://assets.agent-native.com/
|
|
496
|
+
`https://assets.agent-native.com/mcp`.
|
|
497
497
|
|
|
498
498
|
```bash
|
|
499
499
|
# Instalação hospedada mais fácil: instruções de habilidade exportadas mais conector MCP.
|
|
@@ -123,7 +123,7 @@ No dia a dia, o Dispatch é o lugar onde os administradores e o pessoal de opera
|
|
|
123
123
|
Acesso de despacho sem copiar segredos brutos. Fonte específica do aplicativo
|
|
124
124
|
a configuração permanece no aplicativo que usa o provedor.
|
|
125
125
|
- **Exponha um conector MCP.** Adicione
|
|
126
|
-
`https://dispatch.agent-native.com/
|
|
126
|
+
`https://dispatch.agent-native.com/mcp` em Claude, ChatGPT,
|
|
127
127
|
Codex, Cursor ou outro host MCP e escolha quais aplicativos de espaço de trabalho serão
|
|
128
128
|
pode ser acessado na página **Agentes** do Dispatch. Use um aplicativo direto URL
|
|
129
129
|
somente quando esse host deve ser isolado para um aplicativo.
|
|
@@ -304,7 +304,7 @@ _Como funciona nos bastidores (para desenvolvedores)._
|
|
|
304
304
|
]}
|
|
305
305
|
/>
|
|
306
306
|
|
|
307
|
-
- **Modo hub MCP.** O Dispatch ainda pode atuar como o [MCP hub](/docs/mcp-clients#hub) do espaço de trabalho para que todos os outros aplicativos no espaço de trabalho extraiam a mesma lista de servidores MCP de escopo organizacional. Separadamente, o endpoint `/
|
|
307
|
+
- **Modo hub MCP.** O Dispatch ainda pode atuar como o [MCP hub](/docs/mcp-clients#hub) do espaço de trabalho para que todos os outros aplicativos no espaço de trabalho extraiam a mesma lista de servidores MCP de escopo organizacional. Separadamente, o endpoint `/mcp` do próprio Dispatch é o conector MCP externo recomendado para Claude, ChatGPT e outros hosts que devem alcançar vários aplicativos de espaço de trabalho.
|
|
308
308
|
|
|
309
309
|
## Sonhos {#dreams}
|
|
310
310
|
|
|
@@ -116,7 +116,7 @@ O comando instala três comandos: `/visual-plan`, `/visual-recap` e `/visualize-
|
|
|
116
116
|
|
|
117
117
|
Se você estiver usando um host baseado em bate-papo que aceita conectores MCP diretamente dos URLs
|
|
118
118
|
(em vez de um cliente configurado com CLI), conecte o conector de Planos hospedado em
|
|
119
|
-
`https://plan.agent-native.com/
|
|
119
|
+
`https://plan.agent-native.com/mcp` — consulte [MCP Clients](/docs/mcp-clients) para configuração específica do cliente.
|
|
120
120
|
|
|
121
121
|
A autenticação é um login único do navegador durante a configuração — isso é intencional e é
|
|
122
122
|
é o que permite ao agente persistir e compartilhar os planos que gera. O que a autenticação
|
|
@@ -255,7 +255,7 @@ Compartilhar e comentar são os fluxos de trabalho que precisam de uma conta:
|
|
|
255
255
|
revisão entre dispositivos ou em equipe) requer login. O login do Google aparece quando
|
|
256
256
|
as variáveis de ambiente padrão do Google OAuth estão configuradas.
|
|
257
257
|
|
|
258
|
-
O conector de planos hospedados fica em `https://plan.agent-native.com/
|
|
258
|
+
O conector de planos hospedados fica em `https://plan.agent-native.com/mcp`.
|
|
259
259
|
Nunca coloque segredos compartilhados em arquivos de habilidades.
|
|
260
260
|
|
|
261
261
|
## Modo de privacidade de arquivos locais {#local-files}
|
|
@@ -454,7 +454,7 @@ pnpm dev
|
|
|
454
454
|
A habilidade apoiada pelo aplicativo hospedado usa:
|
|
455
455
|
|
|
456
456
|
- Aplicativo: `https://plan.agent-native.com`
|
|
457
|
-
- MCP: `https://plan.agent-native.com/
|
|
457
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
458
458
|
|
|
459
459
|
O modelo local é útil quando você está desenvolvendo os próprios Planos, testando a persistência local ou executando uma superfície de revisão totalmente auto-hospedada.
|
|
460
460
|
|
|
@@ -538,7 +538,7 @@ JSON 输入是代理和复杂对象的首选形状。标志是
|
|
|
538
538
|
|
|
539
539
|
## 通过 MCP 公开它 {#mcp}
|
|
540
540
|
|
|
541
|
-
启用 MCP 后,您的 actions 将显示在框架的 MCP 服务器中,位置为 `/
|
|
541
|
+
启用 MCP 后,您的 actions 将显示在框架的 MCP 服务器中,位置为 `/mcp`。默认情况下,每个调用者都会获得一个紧凑的目录 - 面向应用程序的内置程序以及模板声明的应用程序 actions - 并且 `tool-search` 始终存在,因此任何其他工具都可以按需访问。完整的操作界面仅在明确选择加入(`--full-catalog` 代币或 `AGENT_NATIVE_MCP_FULL_CATALOG=1`)时提供,并且 `publicAgent.expose` 在公共界面上选择安全读取/摄取工具。请参阅 [MCP Protocol](/docs/mcp-protocol) 了解目录层、身份验证和 `mcpApp` 资源详细信息。
|
|
542
542
|
|
|
543
543
|
对于支持 UI 的 MCP 主机,操作可以通过 `mcpApp` 字段(加上匹配的 `link`)声明可选的 MCP Apps 资源,以便有能力的主机内联渲染结果。当 `link` 和 `mcpApp` 应指向同一路线时,`embedRoute()` 从一个纯路径构建器构建两者:
|
|
544
544
|
|
|
@@ -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-15256oc" method="POST" path="/
|
|
118
|
+
<Endpoint id="doc-block-15256oc" 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`,作为对主机友好的轮询间隔。任务必须在第一次响应超时之前就已创建,因此仅在长时间调用之后才返回的轮询 URL 并不是可靠的恢复约定。
|
|
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 工具连接到外部功能的标准协议。当您部署代
|
|
|
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 工具连接到外部功能的标准协议。当您部署代
|
|
|
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 工具连接到外部功能的标准协议。当您部署代
|
|
|
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 主机 | 其他代理本机应用 |
|
|
99
99
|
| **执行** | 直接工具调用(无需额外的LLM) | 完整代理循环(LLM 推理) |
|
|
100
100
|
|
|
@@ -105,7 +105,7 @@ MCP 是用于将 AI 工具连接到外部功能的标准协议。当您部署代
|
|
|
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-1mrk9b2" title={"MCP端点"} summary={"每个代理本机应用程序都会公开自动安装的 Streamable HTTP 端点。"} method="POST" path="/
|
|
143
|
+
<Endpoint id="doc-block-1mrk9b2" title={"MCP端点"} summary={"每个代理本机应用程序都会公开自动安装的 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,32 @@ 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 中应用自持的 `ask_app` 使用相同的持久任务和状态约定,在提交和轮询时都会检查所选应用的授权。
|
|
219
233
|
|
|
220
234
|
## 身份验证 {#authentication}
|
|
221
235
|
|
|
@@ -233,7 +247,7 @@ MCP 端点支持标准远程 MCP OAuth 以及现有的不记名令牌后备:
|
|
|
233
247
|
对于支持 OAuth 的 MCP 主机,配置不带静态标头的远程服务器 URL:
|
|
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
|
第一个未经身份验证的 MCP 请求收到:
|
|
@@ -249,9 +263,9 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
|
|
|
249
263
|
| ----------------------------------------- | ------------------------- |
|
|
250
264
|
| `/.well-known/oauth-protected-resource` | RFC 9728 受保护资源元数据 |
|
|
251
265
|
| `/.well-known/oauth-authorization-server` | OAuth 授权服务器元数据 |
|
|
252
|
-
| `/
|
|
253
|
-
| `/
|
|
254
|
-
| `/
|
|
266
|
+
| `/mcp/oauth/register` | 动态公共客户端注册 |
|
|
267
|
+
| `/mcp/oauth/authorize` | 浏览器授权+同意 |
|
|
268
|
+
| `/mcp/oauth/token` | 授权代码和刷新令牌授予 |
|
|
255
269
|
|
|
256
270
|
<Diagram id="doc-block-bp55uo" title={"OAuth 发现流程"} summary={"401 启动发现、注册和 PKCE 授权 → 令牌交换。不记名令牌是受受众限制和范围的。"}>
|
|
257
271
|
|
|
@@ -351,7 +365,7 @@ export default defineNitroPlugin(async (nitro) => {
|
|
|
351
365
|
您在 `analytics.example.com` 部署了分析应用程序。来自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
|
或者在`.mcp.json`中手动添加:
|
|
@@ -362,7 +376,7 @@ claude mcp add --transport http analytics https://analytics.example.com/_agent-n
|
|
|
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
|
}
|