@agent-native/core 0.98.17 → 0.99.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/corpus/README.md +2 -2
- package/corpus/core/CHANGELOG.md +15 -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/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/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/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-plugin.ts +42 -9
- 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 +6 -0
- 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/global.css +63 -4
- package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx +8 -5
- 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-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/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/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/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/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/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/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/routes.d.ts +2 -2
- 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/file-upload/actions/upload-image.d.ts +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/observability/routes.d.ts +5 -5
- package/dist/provider-api/corpus-jobs.d.ts +2 -2
- package/dist/resources/handlers.d.ts +2 -2
- package/dist/secrets/routes.d.ts +9 -9
- 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/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 +5 -0
- 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 +1 -1
- 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
|
@@ -116,7 +116,7 @@ Der Befehl installiert drei Befehle: `/visual-plan`, `/visual-recap` und `/visua
|
|
|
116
116
|
|
|
117
117
|
Wenn Sie einen Chat-basierten Host verwenden, der MCP-Connector URLs direkt akzeptiert
|
|
118
118
|
(anstelle eines CLI-konfigurierten Clients) verbinden Sie den gehosteten Plans-Connector unter
|
|
119
|
-
`https://plan.agent-native.com/
|
|
119
|
+
`https://plan.agent-native.com/mcp` – siehe [MCP Clients](/docs/mcp-clients) für kundenspezifische Einrichtung.
|
|
120
120
|
|
|
121
121
|
Die Authentifizierung ist eine einmalige Browser-Anmeldung beim Setup – das ist so beabsichtigt und
|
|
122
122
|
ermöglicht es dem Agenten, die von ihm generierten Pläne beizubehalten und zu teilen. Was ist die Authentifizierung?
|
|
@@ -255,7 +255,7 @@ Teilen und Kommentieren sind die Arbeitsabläufe, für die ein Konto erforderlic
|
|
|
255
255
|
geräteübergreifende oder Teambewertung) erfordert eine Anmeldung. Die Google-Anmeldung wird angezeigt, wenn
|
|
256
256
|
Die standardmäßigen Google OAuth-Umgebungsvariablen sind konfiguriert.
|
|
257
257
|
|
|
258
|
-
Der gehostete Plan-Connector befindet sich unter `https://plan.agent-native.com/
|
|
258
|
+
Der gehostete Plan-Connector befindet sich unter `https://plan.agent-native.com/mcp`.
|
|
259
259
|
Fügen Sie niemals gemeinsame Geheimnisse in Skill-Dateien ein.
|
|
260
260
|
|
|
261
261
|
## Datenschutzmodus für lokale Dateien {#local-files}
|
|
@@ -453,7 +453,7 @@ pnpm dev
|
|
|
453
453
|
Der von der gehosteten App unterstützte Skill verwendet:
|
|
454
454
|
|
|
455
455
|
- App: `https://plan.agent-native.com`
|
|
456
|
-
- MCP: `https://plan.agent-native.com/
|
|
456
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
457
457
|
|
|
458
458
|
Die lokale Vorlage ist nützlich, wenn Sie Pläne selbst entwickeln, die lokale Persistenz testen oder eine vollständig selbst gehostete Überprüfungsoberfläche ausführen.
|
|
459
459
|
|
|
@@ -540,7 +540,7 @@ Si su aplicación es del mismo nivel [A2A](/docs/a2a-protocol), otras aplicacion
|
|
|
540
540
|
|
|
541
541
|
## Exponiéndolo sobre MCP {#mcp}
|
|
542
542
|
|
|
543
|
-
Con MCP habilitado, su actions aparece en el servidor MCP del marco en `/
|
|
543
|
+
Con MCP habilitado, su actions aparece en el servidor MCP del marco en `/mcp`. Cada persona que llama recibe un catálogo compacto de forma predeterminada (integraciones orientadas a la aplicación más la aplicación declarada con plantilla actions) y `tool-search` siempre está presente para que cualquier otra herramienta permanezca accesible bajo demanda. La superficie de acción completa se ofrece solo mediante suscripción explícita (token `--full-catalog` o `AGENT_NATIVE_MCP_FULL_CATALOG=1`), y `publicAgent.expose` opta por una herramienta de lectura/ingesta segura en la superficie pública. Consulte [MCP Protocol](/docs/mcp-protocol) para conocer los niveles del catálogo, la autenticación y los detalles del recurso `mcpApp`.
|
|
544
544
|
|
|
545
545
|
Para los hosts MCP compatibles con UI, una acción puede declarar un recurso de aplicaciones MCP opcional a través del campo `mcpApp` (más un `link` coincidente) para que los hosts compatibles representen el resultado en línea. Cuando `link` y `mcpApp` deben apuntar a la misma ruta, `embedRoute()` construye ambos a partir de un generador de rutas puro:
|
|
546
546
|
|
|
@@ -219,7 +219,7 @@ La configuración de estas variables nunca muestra una página de inicio de sesi
|
|
|
219
219
|
El punto final MCP de cada aplicación puede actuar como un recurso MCP protegido estándar. Los clientes compatibles con OAuth se pueden configurar solo con el MCP URL remoto:
|
|
220
220
|
|
|
221
221
|
```text
|
|
222
|
-
https://mail.agent-native.com/
|
|
222
|
+
https://mail.agent-native.com/mcp
|
|
223
223
|
```
|
|
224
224
|
|
|
225
225
|
Las solicitudes MCP no autenticadas devuelven un desafío `WWW-Authenticate` que apunta a `/.well-known/oauth-protected-resource`. Luego, el cliente descubre los metadatos OAuth de la aplicación, registra dinámicamente un cliente público, abre la página de autorización de la aplicación e intercambia un código de autorización con PKCE para acceder y actualizar tokens.
|
|
@@ -113,16 +113,16 @@ Dispatch descubre automáticamente las otras aplicaciones en su espacio de traba
|
|
|
113
113
|
|
|
114
114
|
### Puerta de enlace unificada MCP
|
|
115
115
|
|
|
116
|
-
Dispatch puede ser el único conector MCP para agentes externos: agregue `https://dispatch.agent-native.com/
|
|
116
|
+
Dispatch puede ser el único conector MCP para agentes externos: agregue `https://dispatch.agent-native.com/mcp` una vez en Claude, ChatGPT, Codex o Cursor, y una autorización llega a cada aplicación de espacio de trabajo otorgada en lugar de un conector por aplicación. Consulte [External Agents](/docs/external-agents) para conocer el flujo de conexión completo, las concesiones de aplicaciones, OAuth y las vistas previas de la aplicación MCP en línea.
|
|
117
117
|
|
|
118
|
-
<Endpoint id="doc-block-12cjrag" method="POST" path="/
|
|
118
|
+
<Endpoint id="doc-block-12cjrag" method="POST" path="/mcp" summary="Punto final de puerta de enlace MCP unificada" 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 @@ Agregue un conector MCP remoto al host donde desea utilizar Agent-Native.
|
|
|
98
98
|
Para trabajos en espacios de trabajo o entre aplicaciones, utilice 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 es la puerta de enlace única para Mail, Calendar, Analytics, Brain y tu
|
|
@@ -109,12 +109,12 @@ llegar a todas las aplicaciones o solo a las seleccionadas. El host conectado ob
|
|
|
109
109
|
Para una aplicación aislada intencionalmente, úsela directamente:
|
|
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
|
Cada aplicación alojada también tiene una página de ayuda en
|
|
117
|
-
`https://<app>/
|
|
117
|
+
`https://<app>/mcp/connect` con el URL copiable y
|
|
118
118
|
pestañas específicas del host para Claude, ChatGPT, Cursor, Código Claude, Codex y Otros.
|
|
119
119
|
|
|
120
120
|
### Claude y ChatGPT OAuth {#oauth}
|
|
@@ -238,7 +238,7 @@ Una vez conectado, la autenticación debe persistir a largo plazo: los tokens de
|
|
|
238
238
|
npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
|
|
239
239
|
```
|
|
240
240
|
|
|
241
|
-
`reconnect` encuentra cualquier entrada de configuración MCP cuyo URL termine en `/
|
|
241
|
+
`reconnect` encuentra cualquier entrada de configuración MCP cuyo URL termine en `/mcp` para el host dado y el cliente seleccionado (que coincida con URL independientemente del nombre del conector), luego actualiza o reemplaza el material de autenticación sin tocar su skills instalado ni volver a ejecutar el flujo de instalación completo. Pase la aplicación base URL (por ejemplo, `https://plan.agent-native.com`): se infiere el sufijo `/mcp`. La autenticación y la carga de herramientas son por cliente, así que reinicie/recargue ese cliente después; Codex necesita una nueva sesión antes de que aparezcan las herramientas recién cargadas.
|
|
242
242
|
|
|
243
243
|
En el código Claude, la ruta equivalente a UI es: ejecute `/mcp` y elija **Autenticar** (o **Reconectar**) para el conector correspondiente.
|
|
244
244
|
|
|
@@ -246,7 +246,7 @@ Nunca reinstale la habilidad desde cero solo para arreglar un 401: `reconnect` e
|
|
|
246
246
|
|
|
247
247
|
### Conectar página alternativa {#connect-page-fallback}
|
|
248
248
|
|
|
249
|
-
Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra la aplicación en su navegador y use su opción **Connect** (servida en `https://<app>/
|
|
249
|
+
Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra la aplicación en su navegador y use su opción **Connect** (servida en `https://<app>/mcp/connect`). Una vez que haya iniciado sesión, haga clic en **Conectar/Autorizar**. La página le ofrece un enlace profundo de un solo clic que configura un agente detectado o un bloque `.mcp.json` listo para pegar:
|
|
250
250
|
|
|
251
251
|
```jsonc
|
|
252
252
|
// .mcp.json
|
|
@@ -254,7 +254,7 @@ Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra l
|
|
|
254
254
|
"mcpServers": {
|
|
255
255
|
"mail": {
|
|
256
256
|
"type": "http",
|
|
257
|
-
"url": "https://mail.agent-native.com/
|
|
257
|
+
"url": "https://mail.agent-native.com/mcp",
|
|
258
258
|
"headers": { "Authorization": "Bearer <minted-token>" },
|
|
259
259
|
},
|
|
260
260
|
},
|
|
@@ -271,13 +271,13 @@ Las aplicaciones nativas del agente alojadas también admiten el flujo remoto es
|
|
|
271
271
|
|
|
272
272
|
```bash
|
|
273
273
|
claude mcp add --transport http agent-native \
|
|
274
|
-
https://dispatch.agent-native.com/
|
|
274
|
+
https://dispatch.agent-native.com/mcp
|
|
275
275
|
```
|
|
276
276
|
|
|
277
277
|
Esta es la misma entrada exclusiva para URL que `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` escribe para usted. Luego ejecute `/mcp` en el código Claude y elija **Autenticar**. El cliente descubre la autenticación del desafío `401 WWW-Authenticate` del servidor MCP, recupera `/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`, registra dinámicamente un cliente público OAuth, abre la página de autorización de la aplicación y almacena el token resultante de forma segura. Los conectores en modo desarrollador ChatGPT utilizan el mismo servidor URL:
|
|
278
278
|
|
|
279
279
|
```text
|
|
280
|
-
https://dispatch.agent-native.com/
|
|
280
|
+
https://dispatch.agent-native.com/mcp
|
|
281
281
|
```
|
|
282
282
|
|
|
283
283
|
El flujo OAuth es código de autorización + PKCE con rotación de token de actualización. Los tokens de acceso están vinculados a la audiencia al recurso MCP exacto, URL, y llevan la identidad de usuario/organización firmada, por lo que las llamadas a herramientas, `resources/read` y `tools/call` iniciado por iframe de la aplicación MCP se ejecutan a través del mismo alcance de inquilino `runWithRequestContext` que la ruta JWT creada por conexión existente. El iframe nunca recibe tokens OAuth sin procesar; el host media las llamadas a través de la conexión MCP autenticada.
|
|
@@ -502,13 +502,13 @@ Consulte [MCP Apps](/docs/mcp-apps) para obtener detalles completos del puente:
|
|
|
502
502
|
|
|
503
503
|
Además de las herramientas por acción, el servidor MCP expone un conjunto de verbos estables, por lo que un agente externo tiene una superficie predecible sin adivinar los nombres de acción por aplicación:
|
|
504
504
|
|
|
505
|
-
| Herramienta | Efectos secundarios | Devoluciones
|
|
506
|
-
| -------------------------------------------------- | ------------------- |
|
|
507
|
-
| `list_apps` | ninguno | aplicaciones de espacio de trabajo + sus URL/estado de ejecución
|
|
508
|
-
| `open_app({ app, view?, path?, params?, embed? })` | ninguno | un enlace profundo o una ruta del mismo origen; `embed: true` renderiza la aplicación completa en línea donde sea compatible
|
|
509
|
-
| `ask_app({ app, message })`
|
|
510
|
-
| `create_workspace_app({ name, template })` | andamios | una nueva aplicación iniciada a través de la ruta del espacio de trabajo, además de su URL en ejecución + enlace profundo
|
|
511
|
-
| `list_templates` | ninguno | solo las plantillas incluidas en la lista permitida
|
|
505
|
+
| Herramienta | Efectos secundarios | Devoluciones |
|
|
506
|
+
| -------------------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
507
|
+
| `list_apps` | ninguno | aplicaciones de espacio de trabajo + sus URL/estado de ejecución |
|
|
508
|
+
| `open_app({ app, view?, path?, params?, embed? })` | ninguno | un enlace profundo o una ruta del mismo origen; `embed: true` renderiza la aplicación completa en línea donde sea compatible |
|
|
509
|
+
| `ask_app({ app, message, async?, maxWaitMs? })` | bucle de agente | enruta una tarea en lenguaje natural al agente dentro de la aplicación de esa aplicación; el trabajo largo devuelve un `taskId` duradero para sondear con `ask_app_status` |
|
|
510
|
+
| `create_workspace_app({ name, template })` | andamios | una nueva aplicación iniciada a través de la ruta del espacio de trabajo, además de su URL en ejecución + enlace profundo |
|
|
511
|
+
| `list_templates` | ninguno | solo las plantillas incluidas en la lista permitida |
|
|
512
512
|
|
|
513
513
|
`create_workspace_app` rechaza cualquier plantilla no incluida en la lista de permitidos: la lista de plantillas públicas permitidas en `packages/shared-app-config/templates.ts` tiene autoridad y está protegida por CI; un agente externo no puede ampliarlo. Una acción de plantilla con el mismo nombre anula una acción incorporada (precedencia de plantilla sobre núcleo). Desactive todo el conjunto con `MCPConfig.builtinCrossAppTools: false`.
|
|
514
514
|
|
|
@@ -516,6 +516,19 @@ Los catálogos de herramientas y recursos para hosts de aplicaciones son compact
|
|
|
516
516
|
|
|
517
517
|
Para transferencias rápidas de ChatGPT/Claude, la ruta ideal es directa: llame a la acción que crea o abre el artefacto, luego deje que la aplicación MCP inicie la ruta. Una solicitud de correo debe llamar a `manage_draft` y representar la ruta de redacción real. Una solicitud de panel debe llamar a `open_app({ path, embed: true })` o una acción de panel con `mcpApp` y representar la ruta de análisis completa. Calendario, formularios, contenido, diapositivas, diseño y clips deben seguir el mismo patrón con su borrador/creación/búsqueda actions. `list_apps` es útil cuando el modelo debe elegir entre las aplicaciones otorgadas; `resources/list` amplio, descubrimiento de catálogo completo o delegación de `ask_app` no deberían ser la ruta normal para una transferencia obvia de UI.
|
|
518
518
|
|
|
519
|
+
### Solicitudes de agente de larga duración
|
|
520
|
+
|
|
521
|
+
Los hosts y gateways MCP no comparten un único tiempo de espera largo para las
|
|
522
|
+
llamadas a herramientas; algunos aplican un límite de cinco minutos y otros lo
|
|
523
|
+
hacen configurable. No diseñe una integración de agente externo alrededor de
|
|
524
|
+
una `tools/call` bloqueante de diez minutos. `ask-agent` y `ask_app` confirman
|
|
525
|
+
el trabajo alojado rápidamente y luego devuelven un `taskId` duradero cuando
|
|
526
|
+
expira la espera en línea. Sondee con `ask_app_status` usando el `app` y el
|
|
527
|
+
`taskId` devueltos; el resultado incluye `pollAfterMs` como un intervalo apto
|
|
528
|
+
para hosts. La tarea debe crearse antes de que la primera respuesta pueda
|
|
529
|
+
agotar el tiempo de espera, por lo que una URL de sondeo devuelta solo después
|
|
530
|
+
de una llamada larga no es un contrato de recuperación confiable.
|
|
531
|
+
|
|
519
532
|
### Recorrido por aplicación {#tour}
|
|
520
533
|
|
|
521
534
|
Cada plantilla incluida en la lista permitida que produce o enumera un recurso navegable incluye un generador `link`, y las de ingesta pesada incluyen una acción GET + `publicAgent` para que un agente conectado pueda obtener el estado en vivo:
|
|
@@ -679,7 +692,7 @@ Aprovisiona un token (un `ACCESS_TOKEN` aleatorio en el espacio de trabajo `.env
|
|
|
679
692
|
- **cowork**: la misma forma del código Claude JSON en `~/.cowork/mcp.json`.
|
|
680
693
|
- **codex**: un bloque `[mcp_servers.<name>]` en `~/.codex/config.toml`.
|
|
681
694
|
|
|
682
|
-
La entrada ejecuta `npx @agent-native/core@latest mcp serve --app <id>`, que de forma predeterminada es un **proxy stdio ligero** para el `/
|
|
695
|
+
La entrada ejecuta `npx @agent-native/core@latest mcp serve --app <id>`, que de forma predeterminada es un **proxy stdio ligero** para el `/mcp` de la aplicación local en ejecución, por lo que el registro de acciones en vivo, HMR y los enlaces profundos correctos siguen siendo la única fuente de verdad. Pase `--standalone` para crear el registro en proceso. Cuando `npx @agent-native/core@latest mcp install` detecta un origen alojado (un `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` que no es un host local en el espacio de trabajo `.env`), escribe una entrada de cliente `http` que apunta a `<origin>/mcp` con un `Bearer` JWT en lugar de una entrada stdio.
|
|
683
696
|
|
|
684
697
|
Subcomandos complementarios:
|
|
685
698
|
|
|
@@ -703,7 +716,7 @@ También puede escribir la configuración del cliente MCP a mano en cualquier pu
|
|
|
703
716
|
"mcpServers": {
|
|
704
717
|
"analytics": {
|
|
705
718
|
"type": "http",
|
|
706
|
-
"url": "https://analytics.agent-native.com/
|
|
719
|
+
"url": "https://analytics.agent-native.com/mcp",
|
|
707
720
|
"headers": { "Authorization": "Bearer <ACCESS_TOKEN-or-JWT>" },
|
|
708
721
|
},
|
|
709
722
|
},
|
|
@@ -745,7 +758,7 @@ Las inserciones de aplicaciones completas también evitan entregar el token de p
|
|
|
745
758
|
El flujo `connect` alojado de reserva nunca copia el secreto compartido de la implementación. En lugar de ello:
|
|
746
759
|
|
|
747
760
|
- Una sesión de navegador iniciada genera un token **por usuario, con alcance y revocable**: un JWT firmado por `A2A_SECRET` que lleva el `sub` + `org_domain` de la persona que llama y un `jti` único, por lo que cada ejecución de herramienta permanece dentro del alcance del inquilino a través de `runWithRequestContext`.
|
|
748
|
-
- El punto final `/
|
|
761
|
+
- El punto final `/mcp` existente acepta ese token como cualquier otro portador (ver [MCP Protocol](/docs/mcp-protocol)): ni punto final nuevo, ni transporte nuevo.
|
|
749
762
|
- La misma página de Connect enumera todos los tokens que ha acuñado y le permite **revocar** cualquiera de ellos mediante `jti`. Trátelos como tokens de acceso personal: uno por cliente agente y revoque cuando se desmantele una máquina.
|
|
750
763
|
- El vínculo profundo que el agente devuelve no conlleva ningún estado privilegiado. La escritura `navigate` centrada en registros siempre tiene como alcance la sesión del **navegador**, nunca el token del agente, por lo que es seguro pegar un vínculo en una terminal o en la transcripción del chat.
|
|
751
764
|
|
|
@@ -246,6 +246,18 @@ Esto significa que los usuarios que han instalado la extensión claude-in-chrome
|
|
|
246
246
|
|
|
247
247
|
Los servidores MCP (Protocolo de contexto modelo) le brindan a su agente nuevas capacidades, como conectarse a Zapier, Cloudflare, Composio o las herramientas internas de su empresa. Una vez conectado, el agente puede utilizar esas herramientas al igual que las integradas.
|
|
248
248
|
|
|
249
|
+
Los identificadores de los ajustes preestablecidos son `context7`, `sentry`, `notion`, `semgrep`, `linear`,
|
|
250
|
+
`atlassian`, `supabase`, `neon` y `stripe`.
|
|
251
|
+
|
|
252
|
+
### Atlassian / Jira
|
|
253
|
+
|
|
254
|
+
El ajuste preestablecido de Atlassian usa el punto de conexión OAuth 2.1 de Atlassian Rovo MCP,
|
|
255
|
+
`https://mcp.atlassian.com/v1/mcp/authv2`, y proporciona herramientas de Jira y Confluence. Para crear incidencias de Jira se necesitan los permisos de Atlassian que permiten escribir en Jira; el usuario solo puede ver los proyectos y el contenido a los que su cuenta de Atlassian tiene acceso.
|
|
256
|
+
|
|
257
|
+
Los administradores de una organización de Atlassian pueden controlar si un cliente OAuth tiene permiso para conectarse. Antes de establecer la conexión, es posible que un administrador deba añadir el origen HTTPS real de la aplicación a la lista de dominios de confianza en **Administración de Atlassian → Rovo → Servidor Rovo MCP → Dominios** y habilitar los permisos necesarios de **Lectura**, **Escritura** y **Búsqueda** en **Permisos**. El dominio debe ser el host en el que se ejecuta la aplicación agent-native; no copie `https://builder.io/**` en otro despliegue salvo que ese sea su origen real. Consulte la [guía de configuración de Rovo MCP](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/) y los [controles de administración](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/) de Atlassian.
|
|
258
|
+
|
|
259
|
+
El catálogo proporciona el punto de conexión y las instrucciones de configuración. El formulario de configuración genérico guarda el punto de conexión y los encabezados cifrados opcionales, pero no sustituye el flujo de consentimiento OAuth interactivo de Atlassian. Use un cliente o un entorno de ejecución MCP compatible con OAuth cuando Atlassian requiera OAuth interactivo. Si el proveedor o el entorno de ejecución admite un token Bearer estático, siga el método aprobado para administrar secretos y nunca pegue tokens en prompts ni en archivos de configuración enviados al repositorio.
|
|
260
|
+
|
|
249
261
|
### Cómo conectar un servidor MCP remoto
|
|
250
262
|
|
|
251
263
|
1. **Nombre del servidor**: una etiqueta breve para su propia referencia (por ejemplo, "zapier", "slack-tools").
|
|
@@ -264,7 +276,7 @@ Se admiten dos ámbitos:
|
|
|
264
276
|
|
|
265
277
|
Agrega y elimina la recarga en caliente en el administrador MCP en ejecución: sin reinicio del proceso ni reinicio del servidor. Las nuevas herramientas `mcp__<scope>-<name>__*` le aparecen al agente en el siguiente mensaje y se pueden buscar a través de `tool-search`.
|
|
266
278
|
|
|
267
|
-
HTTPS URL se aceptan en todas partes; `http://` simple solo se permite para `localhost` durante el desarrollo. La autenticación opcional se ingresa como un token de portador que se envía a través de `Authorization: Bearer …` en cada solicitud.
|
|
279
|
+
HTTPS URL se aceptan en todas partes; `http://` simple solo se permite para `localhost` durante el desarrollo. La autenticación opcional se ingresa como un token de portador que se envía a través de `Authorization: Bearer …` en cada solicitud. Los proveedores que solo admiten OAuth, incluido Atlassian Rovo MCP, requieren el flujo OAuth del proveedor en lugar de un encabezado estático.
|
|
268
280
|
|
|
269
281
|
En el fondo, estos servidores persisten en la tabla `settings` del marco bajo la clave `u:<email>:mcp-servers-remote` (Personal) o `o:<orgId>:mcp-servers-remote` (Equipo) y se fusionan con `mcp.config.json` al inicio.
|
|
270
282
|
|
|
@@ -294,7 +306,9 @@ El envío es el centro convencional: ya coordina todas las aplicaciones.
|
|
|
294
306
|
<span class="diagram-pill accent">Dispatch hub</span
|
|
295
307
|
><small class="diagram-muted"
|
|
296
308
|
>servidores MCP con alcance de organización</small
|
|
297
|
-
><small class="diagram-muted"
|
|
309
|
+
><small class="diagram-muted"
|
|
310
|
+
><code>GET /_agent-native/mcp/hub/servers</code></small
|
|
311
|
+
>
|
|
298
312
|
</div>
|
|
299
313
|
<div class="diagram-col arrows">
|
|
300
314
|
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
|
|
@@ -456,7 +470,7 @@ Utilice esto para crear sugerencias de incorporación de "Claude-in-chrome detec
|
|
|
456
470
|
|
|
457
471
|
Las fallas individuales del servidor MCP nunca desactivan el agente:
|
|
458
472
|
|
|
459
|
-
- Un `command` mal configurado → se omite el servidor, su error aparece en `/mcp/status` debajo de `errors.<server-id>` y todos los demás servidores continúan funcionando.
|
|
473
|
+
- Un `command` mal configurado → se omite el servidor, su error aparece en `/_agent-native/mcp/status` debajo de `errors.<server-id>` y todos los demás servidores continúan funcionando.
|
|
460
474
|
- Falta el MCP SDK en `node_modules` → todas las funciones de MCP se omiten con una advertencia; El chat del agente sigue funcionando sin herramientas MCP.
|
|
461
475
|
- Ejecutar en un tiempo de ejecución perimetral → El cliente MCP no funciona.
|
|
462
476
|
|
|
@@ -22,7 +22,7 @@ MCP es el protocolo estándar para conectar herramientas de IA a capacidades ext
|
|
|
22
22
|
|
|
23
23
|
Conceptos clave:
|
|
24
24
|
|
|
25
|
-
- **Montado automáticamente**: cada aplicación obtiene `/
|
|
25
|
+
- **Montado automáticamente**: cada aplicación obtiene `/mcp` gratis, no requiere configuración
|
|
26
26
|
- **HTTP transmitible**: utiliza el transporte moderno MCP sobre el estándar HTTP (POST + SSE)
|
|
27
27
|
- **Mismo actions**: exactamente el mismo registro de acciones que impulsa el chat del agente y A2A
|
|
28
28
|
- **Herramienta `ask-agent`**: una metaherramienta que delega al ciclo completo del agente para tareas complejas
|
|
@@ -41,7 +41,7 @@ Conceptos clave:
|
|
|
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 protocolos se montan automáticamente. Utilice el que se ajuste a su caso
|
|
|
94
94
|
| **Mejor para** | Herramientas externas que llaman a tu aplicación | Comunicación de agente a agente |
|
|
95
95
|
| **Protocolo** | MCP HTTP transmitible | JSON-RPC 2.0 |
|
|
96
96
|
| **Descubrimiento de herramientas** | `tools/list` | Tarjeta de agente en `/.well-known/agent-card.json` |
|
|
97
|
-
| **Punto final** | `/
|
|
97
|
+
| **Punto final** | `/mcp` | `/_agent-native/a2a` |
|
|
98
98
|
| **Con el apoyo de** | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork y otros hosts MCP | Otras aplicaciones nativas del agente |
|
|
99
99
|
| **Ejecución** | Llamadas directas a herramientas (sin LLM adicionales) | Bucle de agente completo (razonamiento LLM) |
|
|
100
100
|
|
|
@@ -105,7 +105,7 @@ También puedes usar la herramienta `ask-agent` MCP para obtener lo mejor de amb
|
|
|
105
105
|
Para la configuración de un solo comando recomendada, utilice [External Agents](/docs/external-agents). Si está escribiendo a mano la configuración de MCP para un cliente compatible con OAuth, agregue su aplicación como un servidor MCP remoto sin encabezados 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
|
O escriba la entrada a mano en `.mcp.json` (alcance del proyecto) o `~/.claude.json` (alcance del usuario):
|
|
@@ -116,7 +116,7 @@ O escriba la entrada a mano en `.mcp.json` (alcance del proyecto) o `~/.claude.j
|
|
|
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
|
Cualquier cliente MCP que admita el transporte Streamable HTTP puede conectarse. El punto final es:
|
|
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
|
El servidor admite el protocolo de enlace estándar MCP: `initialize` → `initialized` → `tools/list` → `tools/call`.
|
|
142
142
|
|
|
143
|
-
<Endpoint id="doc-block-1t35cn" title="Endpoint MCP" summary={"El punto final Streamable HTTP montado automáticamente que expone cada aplicación nativa del agente."} method="POST" path="/
|
|
143
|
+
<Endpoint id="doc-block-1t35cn" title="Endpoint MCP" summary={"El punto final Streamable HTTP montado automáticamente que expone cada aplicación nativa del agente."} method="POST" path="/mcp" summary="MCP Punto final HTTP transmitible" 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,41 @@ Cuando `mcpApp` está presente, la entrada de herramienta también incluye `_met
|
|
|
204
204
|
|
|
205
205
|
Además de las herramientas de acción individuales, cada servidor MCP incluye una metaherramienta `ask-agent`. Esto envía un mensaje en lenguaje natural al agente de inteligencia artificial de la aplicación y devuelve la respuesta.
|
|
206
206
|
|
|
207
|
+
Las solicitudes MCP alojadas usan una espera en línea acotada para que un
|
|
208
|
+
ciclo de agente largo no mantenga abierta una `tools/call` hasta el tiempo de
|
|
209
|
+
espera de un cliente o gateway. El argumento opcional `async` inicia la tarea
|
|
210
|
+
duradera y devuelve el control de inmediato; sin él, el servidor espera
|
|
211
|
+
brevemente una finalización rápida y luego devuelve un identificador de tarea
|
|
212
|
+
cuando queda trabajo pendiente. La espera alojada tiene un límite de 25
|
|
213
|
+
segundos.
|
|
214
|
+
|
|
207
215
|
Utilice `ask-agent` para tareas complejas que se beneficien del razonamiento y el contexto del agente:
|
|
208
216
|
|
|
209
217
|
```json
|
|
210
218
|
{
|
|
211
219
|
"name": "ask-agent",
|
|
212
220
|
"arguments": {
|
|
213
|
-
"message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed"
|
|
221
|
+
"message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed",
|
|
222
|
+
"async": true
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
El agente ejecuta el mismo ciclo que el chat interactivo: puede llamar a múltiples herramientas, razonar sobre el contexto y producir una respuesta reflexiva. Una tarea que no ha terminado devuelve JSON que contiene `taskId`, `status`, `pollAfterMs`, y:
|
|
228
|
+
|
|
229
|
+
```json
|
|
230
|
+
{
|
|
231
|
+
"poll": {
|
|
232
|
+
"tool": "ask_app_status",
|
|
233
|
+
"arguments": { "app": "mail", "taskId": "task_123" }
|
|
214
234
|
}
|
|
215
235
|
}
|
|
216
236
|
```
|
|
217
237
|
|
|
218
|
-
|
|
238
|
+
Llame a `ask_app_status` con esos argumentos hasta que la tarea alcance un
|
|
239
|
+
estado terminal. El `ask_app` propio de cada aplicación en Dispatch usa el
|
|
240
|
+
mismo contrato de tarea y estado duraderos, con la concesión de la aplicación
|
|
241
|
+
seleccionada verificada tanto en el envío como en el sondeo.
|
|
219
242
|
|
|
220
243
|
## Autenticación {#authentication}
|
|
221
244
|
|
|
@@ -233,7 +256,7 @@ El punto final MCP admite MCP OAuth remoto estándar más el respaldo de token d
|
|
|
233
256
|
Para hosts MCP compatibles con OAuth, configure el servidor remoto URL sin encabezados estáticos:
|
|
234
257
|
|
|
235
258
|
```bash
|
|
236
|
-
claude mcp add --transport http agent-native https://dispatch.agent-native.com/
|
|
259
|
+
claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
|
|
237
260
|
```
|
|
238
261
|
|
|
239
262
|
La primera solicitud MCP no autenticada recibe:
|
|
@@ -249,9 +272,9 @@ Puntos finales de descubrimiento:
|
|
|
249
272
|
| ----------------------------------------- | ---------------------------------------------------------------- |
|
|
250
273
|
| `/.well-known/oauth-protected-resource` | RFC 9728 metadatos de recursos protegidos |
|
|
251
274
|
| `/.well-known/oauth-authorization-server` | Metadatos del servidor de autorización OAuth |
|
|
252
|
-
| `/
|
|
253
|
-
| `/
|
|
254
|
-
| `/
|
|
275
|
+
| `/mcp/oauth/register` | Registro dinámico de cliente público |
|
|
276
|
+
| `/mcp/oauth/authorize` | Autorización del navegador + consentimiento |
|
|
277
|
+
| `/mcp/oauth/token` | Concesiones de códigos de autorización y tokens de actualización |
|
|
255
278
|
|
|
256
279
|
<Diagram id="doc-block-1infile" title="OAuth flujo de descubrimiento" summary={"Un 401 inicia el descubrimiento, el registro y una autorización PKCE → intercambio de tokens. El token de portador está limitado a la audiencia y tiene un alcance."}>
|
|
257
280
|
|
|
@@ -351,7 +374,7 @@ export default defineNitroPlugin(async (nitro) => {
|
|
|
351
374
|
Tiene una aplicación de análisis implementada en `analytics.example.com`. Del código Claude:
|
|
352
375
|
|
|
353
376
|
```bash
|
|
354
|
-
claude mcp add --transport http analytics https://analytics.example.com/
|
|
377
|
+
claude mcp add --transport http analytics https://analytics.example.com/mcp
|
|
355
378
|
```
|
|
356
379
|
|
|
357
380
|
O agregarlo a mano en `.mcp.json`:
|
|
@@ -362,7 +385,7 @@ O agregarlo a mano en `.mcp.json`:
|
|
|
362
385
|
"mcpServers": {
|
|
363
386
|
"analytics": {
|
|
364
387
|
"type": "http",
|
|
365
|
-
"url": "https://analytics.example.com/
|
|
388
|
+
"url": "https://analytics.example.com/mcp",
|
|
366
389
|
},
|
|
367
390
|
},
|
|
368
391
|
}
|
|
@@ -12,7 +12,7 @@ La aplicación **Plan** de Agent-Native se envía como un paquete instalable. Un
|
|
|
12
12
|
Una instalación te ofrece:
|
|
13
13
|
|
|
14
14
|
- **Tres skills**: `/visual-plan` (el punto de entrada canónico), `/visual-recap` y `/visualize-repo`.
|
|
15
|
-
- **El conector del plan MCP**: registrado en la aplicación alojada en `https://plan.agent-native.com` (extremo MCP `https://plan.agent-native.com/
|
|
15
|
+
- **El conector del plan MCP**: registrado en la aplicación alojada en `https://plan.agent-native.com` (extremo MCP `https://plan.agent-native.com/mcp`, nombre de servidor `plan`).
|
|
16
16
|
|
|
17
17
|
<Diagram id="doc-block-1i4grvb" title="Tres rutas, un paquete" summary={"El CLI universal, el complemento de Claude Code y el complemento de Codex instalan las mismas skills de Plan más el conector de Plan alojado."}>
|
|
18
18
|
|
|
@@ -43,7 +43,7 @@ Una instalación te ofrece:
|
|
|
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 en el navegador
|
|
252
252
|
```
|
|
253
253
|
|
|
254
|
-
Después de la instalación, **inicie un nuevo subproceso Codex** para que las herramientas skills y MCP se carguen en la sesión. El complemento incluye un conector exclusivo para URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/
|
|
254
|
+
Después de la instalación, **inicie un nuevo subproceso Codex** para que las herramientas skills y MCP se carguen en la sesión. El complemento incluye un conector exclusivo para URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` ejecuta el flujo OAuth. La ruta universal CLI anterior también funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si prefiere un comando que instale y autentique juntos, o cuando desea archivos locales o modo autohospedado.
|
|
255
255
|
|
|
256
256
|
> **Instalaciones anteriores:** si su configuración todavía tiene una entrada `agent-native-plans` que apunta al mismo URL, ejecutando `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` para Codex, o el mismo comando con su `--client` de destino, lo consolida con el nombre canónico `plan`.
|
|
257
257
|
|
|
@@ -269,7 +269,7 @@ El marco monta sus propias rutas bajo `/_agent-native/`. Trate ese espacio de no
|
|
|
269
269
|
| `/_agent-native/extensions/*` | Extensiones de tiempo de ejecución y proxy de extensión (alias heredado: `/_agent-native/tools/*`) |
|
|
270
270
|
| `/_agent-native/integrations/*` | Integraciones de mensajería/webhook |
|
|
271
271
|
| `/_agent-native/a2a` | Agente a agente JSON-RPC |
|
|
272
|
-
| `/
|
|
272
|
+
| `/mcp` | Punto final MCP |
|
|
273
273
|
| `/_agent-native/onboarding/*` | Lista de verificación de configuración |
|
|
274
274
|
| `/_agent-native/observability/*` | Seguimientos, comentarios, evaluaciones, experimentos |
|
|
275
275
|
| `/_agent-native/file-upload` | Punto final del proveedor de carga de archivos |
|
|
@@ -465,4 +465,4 @@ const handler = createProductionAgentHandler({
|
|
|
465
465
|
- [**Base de datos**](/docs/database) — el patrón `getDb()`/`schema` que importan tanto las rutas personalizadas como las acciones
|
|
466
466
|
- [**Seguridad**](/docs/security#access-guards) — `accessFilter`/`assertAccess` y el modelo completo de ámbito de datos
|
|
467
467
|
- [**Mensajería**](/docs/messaging) — el patrón canónico de cola de integración para webhooks entrantes
|
|
468
|
-
- [**Protocolo MCP**](/docs/mcp-protocol) — el endpoint `/
|
|
468
|
+
- [**Protocolo MCP**](/docs/mcp-protocol) — el endpoint `/mcp` que este servidor monta automáticamente
|
|
@@ -313,7 +313,7 @@ Cada habilidad respaldada por la aplicación comienza con `agent-native.app-skil
|
|
|
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 @@ recolector humano UI.
|
|
|
493
493
|
### Desarrollador: distribuir la habilidad de la aplicación
|
|
494
494
|
|
|
495
495
|
La habilidad de la aplicación Assets tiene el ID de aplicación `assets` y está alojado MCP URL
|
|
496
|
-
`https://assets.agent-native.com/
|
|
496
|
+
`https://assets.agent-native.com/mcp`.
|
|
497
497
|
|
|
498
498
|
```bash
|
|
499
499
|
# Instalación alojada más sencilla: instrucciones de habilidades exportadas más conector MCP.
|
|
@@ -123,7 +123,7 @@ Día a día, Dispatch es el lugar donde los administradores y el personal de ope
|
|
|
123
123
|
Acceso de envío sin copiar secretos sin procesar. Fuente específica de la aplicación
|
|
124
124
|
la configuración permanece en la aplicación que utiliza el proveedor.
|
|
125
125
|
- **Exponer un conector MCP.** Agregar
|
|
126
|
-
`https://dispatch.agent-native.com/
|
|
126
|
+
`https://dispatch.agent-native.com/mcp` en Claude, ChatGPT,
|
|
127
127
|
Codex, Cursor u otro host MCP, luego elija qué aplicaciones del espacio de trabajo
|
|
128
128
|
puede comunicarse desde la página **Agentes** de Dispatch. Utilice una aplicación directa URL
|
|
129
129
|
solo cuando ese host debe estar aislado en una aplicación.
|
|
@@ -304,7 +304,7 @@ _Cómo funciona internamente (para desarrolladores)._
|
|
|
304
304
|
]}
|
|
305
305
|
/>
|
|
306
306
|
|
|
307
|
-
- **Modo concentrador MCP.** Dispatch aún puede actuar como [MCP hub](/docs/mcp-clients#hub) del espacio de trabajo, por lo que todas las demás aplicaciones del espacio de trabajo extraen la misma lista de servidores MCP del ámbito de la organización. Por otra parte, el punto final `/
|
|
307
|
+
- **Modo concentrador MCP.** Dispatch aún puede actuar como [MCP hub](/docs/mcp-clients#hub) del espacio de trabajo, por lo que todas las demás aplicaciones del espacio de trabajo extraen la misma lista de servidores MCP del ámbito de la organización. Por otra parte, el punto final `/mcp` de Dispatch es el conector MCP externo recomendado para Claude, ChatGPT y otros hosts que deberían llegar a múltiples aplicaciones de espacio de trabajo.
|
|
308
308
|
|
|
309
309
|
## Sueños {#dreams}
|
|
310
310
|
|
|
@@ -114,7 +114,7 @@ El comando instala tres comandos: `/visual-plan`, `/visual-recap` y `/visualize-
|
|
|
114
114
|
|
|
115
115
|
Si está utilizando un host basado en chat que acepta conectores MCP URL directamente
|
|
116
116
|
(en lugar de un cliente configurado con CLI), conecte el conector de planes alojado en
|
|
117
|
-
`https://plan.agent-native.com/
|
|
117
|
+
`https://plan.agent-native.com/mcp`: consulte [MCP Clients](/docs/mcp-clients) para conocer la configuración específica del cliente.
|
|
118
118
|
|
|
119
119
|
La autenticación es un inicio de sesión único en el navegador durante la configuración; esto es lo que se pretende y
|
|
120
120
|
es lo que permite al agente persistir y compartir los planes que genera. ¿Qué diablos?
|
|
@@ -253,7 +253,7 @@ Compartir y comentar son los flujos de trabajo que necesitan una cuenta:
|
|
|
253
253
|
revisión en varios dispositivos o en equipo) requiere iniciar sesión. El inicio de sesión de Google aparece cuando
|
|
254
254
|
las variables de entorno estándar de Google OAuth están configuradas.
|
|
255
255
|
|
|
256
|
-
El conector de planes alojado se encuentra en `https://plan.agent-native.com/
|
|
256
|
+
El conector de planes alojado se encuentra en `https://plan.agent-native.com/mcp`.
|
|
257
257
|
Nunca coloques secretos compartidos en archivos de habilidades.
|
|
258
258
|
|
|
259
259
|
## Modo de privacidad de archivos locales {#local-files}
|
|
@@ -452,7 +452,7 @@ pnpm dev
|
|
|
452
452
|
La habilidad respaldada por la aplicación alojada utiliza:
|
|
453
453
|
|
|
454
454
|
- Aplicación: `https://plan.agent-native.com`
|
|
455
|
-
- MCP: `https://plan.agent-native.com/
|
|
455
|
+
- MCP: `https://plan.agent-native.com/mcp`
|
|
456
456
|
|
|
457
457
|
La plantilla local es útil cuando estás desarrollando planes, probando la persistencia local o ejecutando una superficie de revisión totalmente autohospedada.
|
|
458
458
|
|
|
@@ -540,7 +540,7 @@ Si votre application est un homologue [A2A](/docs/a2a-protocol), d'autres applic
|
|
|
540
540
|
|
|
541
541
|
## L'exposer sur MCP {#mcp}
|
|
542
542
|
|
|
543
|
-
Avec MCP activé, votre actions apparaît sur le serveur MCP du framework à `/
|
|
543
|
+
Avec MCP activé, votre actions apparaît sur le serveur MCP du framework à `/mcp`. Chaque appelant reçoit par défaut un catalogue compact (intégrés aux applications plus l'application actions déclarée dans le modèle) et `tool-search` est toujours présent afin que tout autre outil reste accessible à la demande. La surface d'action complète n'est servie que sur adhésion explicite (jeton `--full-catalog` ou `AGENT_NATIVE_MCP_FULL_CATALOG=1`), et `publicAgent.expose` opte pour un outil de lecture/ingestion sécurisé sur la surface publique. Consultez [MCP Protocol](/docs/mcp-protocol) pour connaître les niveaux de catalogue, l'authentification et les détails des ressources `mcpApp`.
|
|
544
544
|
|
|
545
545
|
Pour les hôtes MCP compatibles UI, une action peut déclarer une ressource d'applications MCP facultative via le champ `mcpApp` (plus un `link` correspondant) afin que les hôtes capables rendent le résultat en ligne. Lorsque `link` et `mcpApp` doivent pointer vers le même itinéraire, `embedRoute()` construit les deux à partir d'un seul générateur de chemin pur :
|
|
546
546
|
|
|
@@ -219,7 +219,7 @@ La configuration de ces variables ne génère jamais de page de connexion par je
|
|
|
219
219
|
Le point de terminaison MCP de chaque application peut agir comme une ressource MCP protégée standard. Les clients compatibles OAuth peuvent être configurés uniquement avec le MCP URL distant :
|
|
220
220
|
|
|
221
221
|
```text
|
|
222
|
-
https://mail.agent-native.com/
|
|
222
|
+
https://mail.agent-native.com/mcp
|
|
223
223
|
```
|
|
224
224
|
|
|
225
225
|
Les requêtes MCP non authentifiées renvoient un défi `WWW-Authenticate` pointant vers `/.well-known/oauth-protected-resource`. Le client découvre ensuite les métadonnées OAuth de l'application, enregistre dynamiquement un client public, ouvre la page d'autorisation de l'application et échange un code d'autorisation avec PKCE pour les jetons d'accès et d'actualisation.
|
|
@@ -113,16 +113,16 @@ Dispatch découvre automatiquement les autres applications de votre espace de tr
|
|
|
113
113
|
|
|
114
114
|
### Passerelle unifiée MCP
|
|
115
115
|
|
|
116
|
-
Dispatch peut être le connecteur MCP unique pour les agents externes : ajoutez `https://dispatch.agent-native.com/
|
|
116
|
+
Dispatch peut être le connecteur MCP unique pour les agents externes : ajoutez `https://dispatch.agent-native.com/mcp` une fois dans Claude, ChatGPT, Codex ou Cursor, et une autorisation atteint chaque application d'espace de travail accordée au lieu d'un connecteur par application. Consultez [External Agents](/docs/external-agents) pour connaître le flux de connexion complet, les subventions d'application, OAuth et les aperçus de l'application MCP en ligne.
|
|
117
117
|
|
|
118
|
-
<Endpoint id="doc-block-173hyrp" method="POST" path="/
|
|
118
|
+
<Endpoint id="doc-block-173hyrp" method="POST" path="/mcp" summary={"Point de terminaison de passerelle MCP unifiée"} 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
|
|