A connector is a catalog entry or custom definition that describes an external system Bud can connect to. Registry connectors include metadata such as name, provider, category, documentation URL, authentication type, and credential schema.
A gateway is a configured MCP connection created from a registry connector or custom MCP server. Gateways store connection metadata, tags, enabled state, authorization status, and available tools.
A tool is an MCP operation exposed by a gateway. Agents do not automatically receive every tool from a connection; users select the exact tool IDs to attach.
OAuth-capable gateways have an authorization status. Bud starts OAuth with the gateway ID, stores return context during the redirect, and completes the callback with the provider authorization code and state.
An event connection is a shared provider-level source for triggers. Event connections use descriptor-driven credentials, can be project-scoped or global, and may expose a webhook URL after provisioning.
Attaching a connection to an agent stores selected MCP tool IDs in the prompt configuration. Detaching removes the gateway link from that agent only; it does not delete the shared gateway.
Deleting a configured gateway is different from detaching it from an agent. Delete removes the shared connection; detach only updates one agent’s prompt configuration.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Bud Stack Documentation","colors":{"primary":"#965CDE","light":"#965CDE","dark":"#965CDE"},"logo":"https://mintcdn.com/budecosystem-b7b14df4/cmsrSA0apOhMC9-E/images/bud-icon.png?fit=max\u0026auto=format\u0026n=cmsrSA0apOhMC9-E\u0026q=85\u0026s=2c5ed3a452dddd95f2ace02a0231776e","favicon":"https://mintcdn.com/budecosystem-b7b14df4/cmsrSA0apOhMC9-E/images/favicon.ico?fit=max\u0026auto=format\u0026n=cmsrSA0apOhMC9-E\u0026q=85\u0026s=041cbffaa6e0f82d7fa9f460888b8c4f","navbar":{"links":[{"href":"mailto:contact@bud.studio","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/BudEcosystem","github":"https://github.com/BudEcosystem/bud-runtime","linkedin":"https://www.linkedin.com/company/bud-ecosystem"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://budecosystem.com/blog/"},{"anchor":"API Reference","icon":"code","href":"https://budecosystem-b7b14df4.mintlify.app/developer-docs/openai-api/chat"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"budecosystem-b7b14df4","hasAudioNarration":false,"actualSubdomain":"budecosystem-b7b14df4","customDomains":["docs.budecosystem.com"],"gitSource":{"type":"github","owner":"budecosystem","repo":"bud-runtime","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af0980edd82f74d481bcd83","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Product Guide","count":168},{"language":"default","tag":"Guides","count":50},{"language":"default","tag":"API \u0026 SDK Reference","count":47},{"language":"default","tag":"Gateway APIs","count":34},{"language":"default","tag":"Reference","count":21},{"language":"default","tag":"Prompts \u0026 Agents","count":16},{"language":"default","tag":"Models","count":12},{"language":"default","tag":"Python SDK \u0026 CLI","count":11},{"language":"default","tag":"MCP Foundry","count":11},{"language":"default","tag":"Guardrails","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"connectors/connector-concepts","slug":"/connectors/connector-concepts","pageMetadata":{"title":"Connector Concepts","description":"Core concepts behind Bud connectors, connections, gateways, tools, and triggers","href":"/connectors/connector-concepts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Mermaid,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`connector`,children:`Connector`}),`\n`,_jsx(_components.p,{children:`A connector is a catalog entry or custom definition that describes an external system Bud can connect to. Registry connectors include metadata such as name, provider, category, documentation URL, authentication type, and credential schema.`}),`\n`,_jsx(Heading,{level:`2`,id:`gateway`,children:`Gateway`}),`\n`,_jsx(_components.p,{children:`A gateway is a configured MCP connection created from a registry connector or custom MCP server. Gateways store connection metadata, tags, enabled state, authorization status, and available tools.`}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[Registry Connector] -->|configure credentials| B[Gateway]\n C[Custom MCP Server] -->|create custom gateway| B\n B --> D[OAuth Status]\n B --> E[Tool List]\n B --> F[Visibility Tags]\n E --> G[Agent Prompt Config]`}),`\n`,_jsx(Heading,{level:`2`,id:`tool`,children:`Tool`}),`\n`,_jsx(_components.p,{children:`A tool is an MCP operation exposed by a gateway. Agents do not automatically receive every tool from a connection; users select the exact tool IDs to attach.`}),`\n`,_jsx(Heading,{level:`2`,id:`oauth-status`,children:`OAuth Status`}),`\n`,_jsx(_components.p,{children:`OAuth-capable gateways have an authorization status. Bud starts OAuth with the gateway ID, stores return context during the redirect, and completes the callback with the provider authorization code and state.`}),`\n`,_jsx(Heading,{level:`2`,id:`visibility-scope`,children:`Visibility Scope`}),`\n`,_jsx(_components.p,{children:`Connector visibility controls where a configured connection can be used.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scope`}),_jsx(_components.th,{children:`Behavior`}),_jsx(_components.th,{children:`Best For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Global`})}),_jsx(_components.td,{children:`Agents in all projects can discover the connection.`}),_jsx(_components.td,{children:`Organization-wide systems and shared internal tools.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Project`})}),_jsx(_components.td,{children:`Only selected project IDs can discover the connection.`}),_jsx(_components.td,{children:`Team-specific systems, restricted data, or staged rollout.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Disabled`})}),_jsx(_components.td,{children:`The connection exists but is not available to agents.`}),_jsx(_components.td,{children:`Maintenance, incident response, or temporary suspension.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`event-connection`,children:`Event Connection`}),`\n`,_jsx(_components.p,{children:`An event connection is a shared provider-level source for triggers. Event connections use descriptor-driven credentials, can be project-scoped or global, and may expose a webhook URL after provisioning.`}),`\n`,_jsx(Heading,{level:`2`,id:`trigger-provider-descriptor`,children:`Trigger Provider Descriptor`}),`\n`,_jsx(_components.p,{children:`Provider descriptors define event credentials, provider metadata, sample payloads, and grouping suggestions. Bud Admin uses descriptors to render the credentials step and trigger grouping experience without hardcoding provider-specific fields.`}),`\n`,_jsx(Heading,{level:`2`,id:`prompt-attachment`,children:`Prompt Attachment`}),`\n`,_jsx(_components.p,{children:`Attaching a connection to an agent stores selected MCP tool IDs in the prompt configuration. Detaching removes the gateway link from that agent only; it does not delete the shared gateway.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting a configured gateway is different from detaching it from an agent. Delete removes the shared connection; detach only updates one agent’s prompt configuration.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connector Concepts","description":"Core concepts behind Bud connectors, connections, gateways, tools, and triggers","href":"/connectors/connector-concepts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connector","slug":"connector","depth":2,"children":[]},{"title":"Gateway","slug":"gateway","depth":2,"children":[]},{"title":"Tool","slug":"tool","depth":2,"children":[]},{"title":"OAuth Status","slug":"oauth-status","depth":2,"children":[]},{"title":"Visibility Scope","slug":"visibility-scope","depth":2,"children":[]},{"title":"Event Connection","slug":"event-connection","depth":2,"children":[]},{"title":"Trigger Provider Descriptor","slug":"trigger-provider-descriptor","depth":2,"children":[]},{"title":"Prompt Attachment","slug":"prompt-attachment","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"budecosystem-b7b14df4","siteName":"Bud Stack Documentation","title":"Connector Concepts - Bud Stack Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-10T12:12:53.304Z","originalFileLocation":"connectors/connector-concepts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bud Stack Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connector Concepts - Bud Stack Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bud Stack Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.budecosystem.com/connectors/connector-concepts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://budecosystem-b7b14df4.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connector+Concepts\u0026amp;description=Core+concepts+behind+Bud+connectors%2C+connections%2C+gateways%2C+tools%2C+and+triggers\u0026amp;theme=a939dd8b525f63e2d991140a\u0026amp;signature=3a1748fb53b9096ad478e6a50758f316fc561da210f0137abbb21b8c8e95ae8e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connector Concepts - Bud Stack Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://budecosystem-b7b14df4.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connector+Concepts\u0026amp;description=Core+concepts+behind+Bud+connectors%2C+connections%2C+gateways%2C+tools%2C+and+triggers\u0026amp;theme=a939dd8b525f63e2d991140a\u0026amp;signature=3a1748fb53b9096ad478e6a50758f316fc561da210f0137abbb21b8c8e95ae8e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/budecosystem-b7b14df4/YJxoAyH9LYElHp2j/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bud Stack Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#965CDE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.budecosystem.com/connectors/connector-concepts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/connectors/connector-concepts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.budecosystem.com/#organization\",\"name\":\"Bud Stack Documentation\",\"url\":\"https://docs.budecosystem.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/budecosystem-b7b14df4/cmsrSA0apOhMC9-E/images/bud-icon.png?fit=max\u0026auto=format\u0026n=cmsrSA0apOhMC9-E\u0026q=85\u0026s=2c5ed3a452dddd95f2ace02a0231776e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.budecosystem.com#website\",\"name\":\"Bud Stack Documentation\",\"url\":\"https://docs.budecosystem.com\",\"publisher\":{\"@id\":\"https://docs.budecosystem.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.budecosystem.com/connectors/connector-concepts#webpage\",\"url\":\"https://docs.budecosystem.com/connectors/connector-concepts\",\"name\":\"Connector Concepts\",\"description\":\"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\",\"dateModified\":\"2026-08-10T12:12:53.304Z\",\"isPartOf\":{\"@id\":\"https://docs.budecosystem.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.budecosystem.com/connectors/connector-concepts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.budecosystem.com/connectors/connector-concepts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connectors\",\"item\":\"https://docs.budecosystem.com/connectors/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connector Concepts\",\"item\":\"https://docs.budecosystem.com/connectors/connector-concepts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.budecosystem.com/connectors/connector-concepts#article\",\"headline\":\"Connector Concepts\",\"name\":\"Connector Concepts\",\"description\":\"Core concepts behind Bud connectors, connections, gateways, tools, and triggers\",\"url\":\"https://docs.budecosystem.com/connectors/connector-concepts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.budecosystem.com/connectors/connector-concepts#webpage\"},\"dateModified\":\"2026-08-10T12:12:53.304Z\",\"publisher\":{\"@id\":\"https://docs.budecosystem.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.budecosystem.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bud Stack Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bud Stack Documentation","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://budecosystem.com/blog/"},{"anchor":"API Reference","icon":"code","href":"https://budecosystem-b7b14df4.mintlify.app/developer-docs/openai-api/chat"}]},"tabs":[{"tab":"Product Guide","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Introduction to Bud AI Foundry","href":"/getting-started/introduction"},{"title":"Quick Start Guide","href":"/getting-started/quickstart"},{"title":"Platform Overview","href":"/getting-started/platform-overview"},{"title":"Account Setup","href":"/getting-started/account-setup"},{"title":"Key Concepts","href":"/getting-started/key-concepts"}]},{"group":"Projects","icon":"folder-tree","pages":[{"title":"Introduction to Projects","href":"/projects/introduction"},{"title":"Quick Start","href":"/projects/quickstart"},{"title":"Project Concepts","href":"/projects/project-concepts"},{"title":"Creating Your First Project","href":"/projects/creating-first-project"},{"group":"Guides","pages":[{"title":"Managing Project Members","href":"/projects/guides/managing-project-members"},{"title":"Deployment Settings and Autoscaling","href":"/projects/guides/deployment-settings-and-autoscaling"}]},{"group":"Reference","pages":[{"title":"Project Tabs Reference","href":"/projects/reference/project-tabs-reference"}]},{"title":"Troubleshooting","href":"/projects/troubleshooting"}]},{"group":"Models","icon":"brain","pages":[{"title":"Introduction to Models","href":"/models/introduction"},{"title":"Quickstart","href":"/models/quickstart"},{"title":"Model Concepts","href":"/models/model-concepts"},{"title":"Creating Your First Model","href":"/models/creating-first-model"},{"group":"Guides","pages":[{"title":"Model Security and Verification","href":"/models/guides/model-security-and-verification"},{"title":"Evaluations","href":"/models/guides/evaluations"},{"title":"Automated Model License Analysis","href":"/models/guides/automated-model-license-analysis"},{"title":"Performance Benchmarks","href":"/models/guides/performance-benchmarks"},{"title":"Tool Calling and Reasoning Parser","href":"/models/guides/tool-calling-and-reasoning-parser"},{"title":"How to Add Adapters to Your Deployed Models","href":"/models/guides/how-to-add-adapters-to-your-deployed-models"}]},{"group":"Reference","pages":[{"title":"Model Operations Reference","href":"/models/reference/model-operations-reference"}]},{"title":"Troubleshooting","href":"/models/troubleshooting"}]},{"group":"Deployments","icon":"rocket","pages":[{"title":"Introduction to Deployments","href":"/deployments/introduction"},{"title":"Quick Start","href":"/deployments/quickstart"},{"title":"Deployment Concepts","href":"/deployments/deployment-concepts"},{"title":"Creating Your First Deployment","href":"/deployments/creating-first-deployment"},{"group":"Guides","pages":[{"title":"Deployment Lifecycle Management","href":"/deployments/guides/deployment-lifecycle-management"}]},{"group":"Reference","pages":[{"title":"Deployment Actions Reference","href":"/deployments/reference/deployment-actions-reference"}]},{"title":"Troubleshooting","href":"/deployments/troubleshooting"}]},{"group":"Pipelines","icon":"diagram-project","pages":[{"title":"Introduction to Pipelines","href":"/pipelines/introduction"},{"title":"Quick Start","href":"/pipelines/quickstart"},{"title":"Pipeline Concepts","href":"/pipelines/pipeline-concepts"},{"title":"Creating Your First Pipeline","href":"/pipelines/creating-first-pipeline"},{"group":"Guides","pages":[{"title":"Scheduled Pipelines","href":"/pipelines/guides/scheduled-pipelines"},{"title":"Event-Driven Pipelines","href":"/pipelines/guides/event-driven-pipelines"}]},{"group":"Reference","pages":[{"title":"Actions Reference","href":"/pipelines/reference/actions-reference"}]},{"title":"Troubleshooting","href":"/pipelines/troubleshooting"}]},{"group":"Connectors","icon":"plug","pages":[{"title":"Introduction to Connectors","href":"/connectors/introduction"},{"title":"Quick Start","description":"Configure and use your first connector in minutes","href":"/connectors/quickstart"},{"title":"Connector Concepts","href":"/connectors/connector-concepts"},{"title":"Creating Your First Connector","description":"Step-by-step tutorial for creating a reusable connector connection","href":"/connectors/creating-first-connector"},{"group":"Guides","pages":[{"title":"MCP Tool Connectors","href":"/connectors/guides/mcp-tool-connectors"},{"title":"Event Connections","href":"/connectors/guides/event-connections"}]},{"group":"Reference","pages":[{"title":"Connectors Reference","href":"/connectors/reference/connectors-reference"}]},{"title":"Troubleshooting","href":"/connectors/troubleshooting"}]},{"group":"MCP Foundry","icon":"plug","pages":[{"title":"Introduction to MCP Foundry","href":"/mcp-foundry/introduction"},{"title":"Quick Start","href":"/mcp-foundry/quickstart"},{"title":"MCP Foundry Concepts","href":"/mcp-foundry/mcp-foundry-concepts"},{"title":"Create Your First MCP Server","href":"/mcp-foundry/creating-first-mcp-foundry"},{"group":"Guides","pages":[{"title":"Configure MCP Server","href":"/mcp-foundry/guides/configuring-gateways"},{"title":"Manage MCP capabilities","href":"/mcp-foundry/guides/manage-mcp-capabilities"},{"title":"Turn knowledge into agent-ready resources","href":"/mcp-foundry/guides/agent-ready-resources"},{"title":"Create portable AI skills","href":"/mcp-foundry/guides/portable-ai-skills"},{"title":"Manage AI prompts at scale","href":"/mcp-foundry/guides/manage-prompts-at-scale"}]},{"group":"Reference","pages":[{"title":"MCP Foundry Reference","href":"/mcp-foundry/reference/mcp-foundry-reference"}]},{"title":"Troubleshooting","href":"/mcp-foundry/troubleshooting"}]},{"group":"Router","icon":"route","pages":[{"title":"Introduction to Router","href":"/router/introduction"},{"title":"Quick Start","href":"/router/quickstart"},{"title":"Router Concepts","href":"/router/router-concepts"},{"title":"Creating Your First Router","href":"/router/creating-first-router"},{"group":"Guides","pages":[{"title":"Router Connection Rules","href":"/router/guides/connection-rules"},{"title":"Using Router API","href":"/router/guides/using-router-api"}]},{"group":"Reference","pages":[{"title":"Router Actions Reference","href":"/router/reference/router-actions-reference"}]},{"title":"Troubleshooting","href":"/router/troubleshooting"}]},{"group":"Clusters","icon":"server","pages":[{"title":"Introduction to Clusters","href":"/clusters/introduction"},{"title":"Quick Start","href":"/clusters/quickstart"},{"title":"Cluster Concepts","href":"/clusters/cluster-concepts"},{"title":"Creating Your First Cluster","href":"/clusters/creating-first-cluster"},{"group":"Guides","pages":[{"title":"Cluster Operations","href":"/clusters/guides/cluster-operations"},{"title":"Cluster Settings and Storage Defaults","href":"/clusters/guides/cluster-settings-and-storage"}]},{"group":"Reference","pages":[{"title":"Cluster Tabs Reference","href":"/clusters/reference/cluster-tabs-reference"}]},{"title":"Troubleshooting","href":"/clusters/troubleshooting"}]},{"group":"API Integration","icon":"code","pages":[{"title":"Introduction to API Integration","href":"/api-integration/introduction"},{"title":"Quickstart","href":"/api-integration/quickstart"},{"title":"API Integration Concepts","href":"/api-integration/api-integration-concepts"},{"title":"Creating Your First API Integration","href":"/api-integration/creating-first-api-integration"},{"group":"Guides","pages":[{"title":"OpenAI-Compatible Client Guide","href":"/api-integration/guides/openai-compatible-clients"},{"title":"Webhook and Retry Patterns","href":"/api-integration/guides/webhook-and-retry-patterns"}]},{"group":"Reference","pages":[{"title":"Request \u0026 Response Reference","href":"/api-integration/reference/request-response-reference"}]},{"title":"Troubleshooting","href":"/api-integration/troubleshooting"}]},{"group":"Playground","icon":"flask","pages":[{"title":"Introduction to Playground","href":"/playground/introduction"},{"title":"Quick Start","href":"/playground/quickstart"},{"title":"Playground Concepts","href":"/playground/playground-concepts"},{"title":"Creating Your First Playground Workflow","href":"/playground/creating-first-playground"},{"group":"Guides","pages":[{"title":"Model Comparison Workflows","href":"/playground/guides/model-comparison-workflows"},{"title":"Prompt Engineering Patterns","href":"/playground/guides/prompt-engineering-patterns"}]},{"group":"Reference","pages":[{"title":"Playground Actions Reference","href":"/playground/reference/playground-actions-reference"}]},{"title":"Troubleshooting Playground","href":"/playground/troubleshooting"}]},{"group":"Observability","icon":"chart-line","pages":[{"title":"Introduction to Observability","href":"/observability/introduction"},{"title":"Quick Start","href":"/observability/quickstart"},{"title":"Observability Concepts","href":"/observability/observability-concepts"},{"title":"Creating Your First Investigation","href":"/observability/creating-first-observability"},{"group":"Guides","pages":[{"title":"Request Investigations","href":"/observability/guides/request-investigations"},{"title":"Rule Management","href":"/observability/guides/rule-management"}]},{"group":"Reference","pages":[{"title":"Observability Reference","href":"/observability/reference/observability-reference"}]},{"title":"Troubleshooting","href":"/observability/troubleshooting"}]},{"group":"Dashboard","icon":"gauge-high","pages":[{"title":"Introduction to Dashboard","href":"/dashboard/introduction"},{"title":"Quick Start","href":"/dashboard/quickstart"},{"title":"Dashboard Concepts","href":"/dashboard/dashboard-concepts"},{"title":"Creating Your First Dashboard Workflow","href":"/dashboard/creating-first-dashboard"},{"group":"Guides","pages":[{"title":"Operational Monitoring Guide","href":"/dashboard/guides/operational-monitoring"}]},{"group":"Reference","pages":[{"title":"Dashboard Metrics Reference","href":"/dashboard/reference/metrics-reference"}]},{"title":"Troubleshooting","href":"/dashboard/troubleshooting"}]},{"group":"Prompts \u0026 Agents","icon":"wand-magic-sparkles","pages":[{"title":"Introduction to Agents","href":"/prompts-agents/introduction"},{"title":"Quick Start","href":"/prompts-agents/quickstart"},{"title":"Agent Concepts","href":"/prompts-agents/agent-concepts"},{"title":"Creating Your First Agent","href":"/prompts-agents/creating-first-agent"},{"group":"Guides","pages":[{"title":"Agent Version Management","href":"/prompts-agents/guides/version-management"},{"title":"Tool Connectors for Agents","href":"/prompts-agents/guides/tool-connectors"},{"title":"Context Compaction","href":"/prompts-agents/guides/context-compaction"},{"title":"Default Variables","href":"/prompts-agents/guides/default-variables"},{"group":"Native Tools","pages":[{"title":"Native Tools","href":"/prompts-agents/guides/native-tools/introduction"},{"title":"Web Search","href":"/prompts-agents/guides/native-tools/web-search"},{"title":"Web Fetch","href":"/prompts-agents/guides/native-tools/web-fetch"},{"title":"Atlas Knowledge","href":"/prompts-agents/guides/native-tools/atlas-knowledge"},{"title":"Code Interpreter","href":"/prompts-agents/guides/native-tools/code-interpreter"},{"title":"Task Planner","href":"/prompts-agents/guides/native-tools/task-planner"}]}]},{"group":"Reference","pages":[{"title":"Agents Reference","href":"/prompts-agents/reference/agents-reference"}]},{"title":"Troubleshooting","href":"/prompts-agents/troubleshooting"}]},{"group":"Evaluations","icon":"chart-bar","pages":[{"title":"Introduction to Evaluations","href":"/evaluations/introduction"},{"title":"Quick Start","href":"/evaluations/quickstart"},{"title":"Evaluation Concepts","href":"/evaluations/evaluation-concepts"},{"title":"Creating Your First Evaluation","href":"/evaluations/creating-first-evaluation"},{"group":"Guides","pages":[{"title":"Running Evaluations","href":"/evaluations/guides/running-evaluations"},{"title":"Evaluating Agents","href":"/evaluations/guides/evaluating-agents"},{"title":"Comparing Models","href":"/evaluations/guides/comparing-models"}]},{"group":"Reference","pages":[{"title":"Evaluations Reference","href":"/evaluations/reference/evaluations-reference"}]},{"title":"Troubleshooting","href":"/evaluations/troubleshooting"}]},{"group":"Guardrails","icon":"shield-halved","pages":[{"title":"Introduction to Guardrail","href":"/guardrail/introduction"},{"title":"Quick Start","href":"/guardrail/quickstart"},{"title":"Guardrail Concepts","href":"/guardrail/guardrail-concepts"},{"title":"Creating Your First Guardrail","href":"/guardrail/creating-first-guardrail"},{"title":"Governance Policy","href":"/guardrail/governance-policy"},{"title":"Bud Sentinel","href":"/guardrail/bud-sentinel"},{"group":"Guides","pages":[{"title":"Provider and Probe Strategy","href":"/guardrail/guides/provider-and-probe-strategy"},{"title":"Deployment and Operations","href":"/guardrail/guides/deployment-and-operations"}]},{"group":"Reference","pages":[{"title":"Guardrail Reference","href":"/guardrail/reference/guardrail-reference"}]},{"title":"Troubleshooting","href":"/guardrail/troubleshooting"}]},{"group":"API Keys \u0026 Security","icon":"key","pages":[{"title":"Introduction to API Keys","href":"/api-keys/introduction"},{"title":"Quick Start","href":"/api-keys/quickstart"},{"title":"API Key Concepts","href":"/api-keys/api-key-concepts"},{"title":"Creating Your First API Key","href":"/api-keys/creating-first-api-key"},{"group":"Guides","pages":[{"title":"Rotating Keys","href":"/api-keys/guides/rotating-keys"},{"title":"Security Best Practices","href":"/api-keys/guides/security-best-practices"}]},{"group":"Reference","pages":[{"title":"Permissions \u0026 Rate-Limit Reference","href":"/api-keys/reference/permissions-and-rate-limits-reference"}]},{"title":"Troubleshooting","href":"/api-keys/troubleshooting"}]},{"group":"User Management","icon":"users","pages":[{"title":"Introduction to User Management","href":"/user-management/introduction"},{"title":"Quick Start","href":"/user-management/quickstart"},{"title":"User Management Concepts","href":"/user-management/user-management-concepts"},{"title":"Creating Your First User Management Setup","href":"/user-management/creating-first-user-management"},{"title":"Inviting Users","href":"/user-management/inviting-users"},{"group":"Guides","pages":[{"title":"Onboarding and Offboarding","href":"/user-management/guides/onboarding-and-offboarding"},{"title":"Access Review Workflow","href":"/user-management/guides/access-review-workflow"}]},{"group":"Reference","pages":[{"title":"User Types \u0026 Permissions","href":"/user-management/roles-permissions"},{"title":"Permissions Reference","href":"/user-management/reference/permissions-reference"}]},{"title":"Troubleshooting","href":"/user-management/troubleshooting"}]},{"group":"Customer Dashboard","icon":"user","pages":[{"title":"Customer Dashboard Portal Introduction","href":"/product-guide/customer-dashboard/introduction"},{"title":"Quickstart","href":"/product-guide/customer-dashboard/quickstart"},{"title":"Customer Dashboard Concepts","href":"/product-guide/customer-dashboard/customer-dashboard-concepts"},{"title":"Creating Your First Customer Dashboard Workflow","href":"/product-guide/customer-dashboard/creating-first-customer-dashboard-workflow"},{"group":"Guides","pages":[{"title":"Managing API Keys and Projects","href":"/product-guide/customer-dashboard/guides/managing-api-keys-and-projects"},{"title":"Observability and Usage Monitoring","href":"/product-guide/customer-dashboard/guides/observability-and-usage-monitoring"}]},{"group":"Reference","pages":[{"title":"Customer Dashboard Reference","href":"/product-guide/customer-dashboard/reference/customer-dashboard-reference"}]},{"title":"Troubleshooting","href":"/product-guide/customer-dashboard/troubleshooting"}]},{"group":"Settings","icon":"gear","pages":[{"title":"Account Settings","href":"/settings/account-settings"}]}]},{"tab":"API \u0026 SDK Reference","pages":[{"title":"API \u0026 SDK Reference","href":"/api-sdk/overview"}]},{"tab":"Developer Docs","pages":[{"title":"Developer Docs","href":"/developer-docs/installation"}]}]},"basePath":"","title":"Connector Concepts - Bud Stack Documentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}