How to connect to a gRPC Resource using the Formal Connector
Requirements
Networking
Certain ports must be accessible to connect to Formal Resources. You can listen on multiple ports simultaneously for various Resources.gRPC is a high-performance, open-source Remote Procedure Call (RPC) framework that uses HTTP/2 for transport, Protocol Buffers as the interface description language, and provides features like authentication, bidirectional streaming, and flow control. The Formal Connector enables you to proxy and monitor gRPC traffic to your APIs while enforcing policies and logging all interactions.
The connector runs a healthcheck server on port 8080 to let clients determine if the proxy is operational. As a result, you cannot create a listener on port 8080 to connect to a gRPC resource.
Resource health check
Formal periodically checks that the Connector can open a TCP connection to the gRPC server. When TLS is enabled for the Resource, the check also completes a TLS handshake. It does not send gRPC requests.
Native Users
The Connector can inject upstream credentials with Native Users. gRPC Resources accept the HTTP credential types, such as HTTP Bearer and API Key (Header). Header credentials reach the server as gRPC metadata.To send each user’s own OAuth token instead, use linked accounts.
Connect to a gRPC Resource
To connect to a gRPC resource with a Formal identity, set the following metadata in your gRPC calls:
x-formal-user-username: The username of the user making the request
x-formal-user-password: The user’s authentication credentials
Connecting using the gRPC CLI
To connect using grpc_cli, execute the following command:
Make sure to replace CONNECTOR_HOSTNAME, PORT, GRPC_METHOD_NAME, FORMAL_USERNAME, and FORMAL_ACCESS_TOKEN with the right values.
Smart Routing
The Connector features Smart Routing for gRPC, allowing the linkage of an
unlimited number of Resources over the same port.Prefix the Connector hostname with the resource name:
Replace RESOURCE_NAME, CONNECTOR_HOSTNAME, PORT, GRPC_METHOD_NAME,
FORMAL_USERNAME, and FORMAL_ACCESS_TOKEN with the right values.If your gRPC client dials one address and sends a separate authority or server
name, set that value to RESOURCE_NAME.CONNECTOR_HOSTNAME.
Make sure your DNS entries are properly configured to handle the subdomain
routing, i.e. that *.CONNECTOR_HOSTNAME targets your Connector. Use a
wildcard TLS certificate that covers every resource subdomain.
Policy Evaluation
Formal supports the following policy evaluation stages for gRPC:
Session: Evaluate and enforce policies at connection time
Request: Evaluate and enforce policies before request execution
Policies and Controls
You can apply Formal policies to gRPC traffic at the session and request stages. The gRPC method name is available as input.grpc.method_name.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Formal Documentation","colors":{"primary":"#3D6EFF","light":"#345DD9","dark":"#2847A6"},"logo":{"light":"https://mintcdn.com/formal/LPWo9xz8zdnEa7zx/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=LPWo9xz8zdnEa7zx\u0026q=85\u0026s=62917f1d8ace80d33c05e036424ba8c7","dark":"https://mintcdn.com/formal/LPWo9xz8zdnEa7zx/assets/logos/dark.svg?fit=max\u0026auto=format\u0026n=LPWo9xz8zdnEa7zx\u0026q=85\u0026s=707b81c553029a2926b5e27714b0ea52"},"favicon":"https://mintcdn.com/formal/o7iKdFQSKSkKCIw_/assets/favicon.svg?fit=max\u0026auto=format\u0026n=o7iKdFQSKSkKCIw_\u0026q=85\u0026s=4c21e09049a1e194dc3de2b7db9baf6d","api":{"playground":{"display":"simple","proxy":false}},"navbar":{"links":[{"href":"https://www.joinformal.com/blog/","label":"Blog"},{"href":"mailto:support@joinformal.com","label":"Support"}],"primary":{"type":"button","label":"Control Plane","href":"https://app.formal.ai"}},"footer":{"socials":{"x":"https://x.com/joinformal","github":"https://github.com/formalco","linkedin":"https://linkedin.com/company/formalhq"}},"styling":{"codeblocks":{"languages":{"custom":["/languages/cel.json","/languages/rego.json"]}},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"formal","hasAudioNarration":false,"actualSubdomain":"formal","customDomains":["docs.formal.ai"],"gitSource":{"type":"github","owner":"formalco","repo":"product-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0201867e3e281bf5affa8f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API","count":411},{"language":"default","tag":"Documentation","count":189},{"language":"default","tag":"Configuring Formal","count":146},{"language":"default","tag":"MCP Gateway","count":76},{"language":"default","tag":"MCP Servers","count":75},{"language":"default","tag":"Resource","count":56},{"language":"default","tag":"core.v1.ResourceService","count":56},{"language":"default","tag":"Connectors","count":52},{"language":"default","tag":"core.v1.ConnectorService","count":52},{"language":"default","tag":"Policies","count":33}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"690910a1a24419e70db3241a","deploymentId":"68f143cf25a9e16daec4ddf1","questionText":"How do I create access policies?","status":"active","generatedBy":"manual","createdAt":"2025-11-03T20:29:21.521Z","updatedAt":"2025-11-03T20:29:21.521Z","__v":0},{"_id":"69091085a24419e70db3227e","deploymentId":"68f143cf25a9e16daec4ddf1","questionText":"What resources can I protect?","status":"active","generatedBy":"manual","createdAt":"2025-11-03T20:28:53.869Z","updatedAt":"2025-11-03T20:29:00.423Z","__v":0},{"_id":"6909107ba24419e70db321e2","deploymentId":"68f143cf25a9e16daec4ddf1","questionText":"How do I deploy a Connector?","status":"active","generatedBy":"manual","createdAt":"2025-11-03T20:28:43.537Z","updatedAt":"2025-11-03T20:28:43.537Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"docs/global.css","content":".mcp-server-page span[data-as=\"p\"]{display:block;margin:1rem 0}.mcp-server-page h2{margin-top:3rem}.mcp-server-tabs{border:1px solid rgba(107, 114, 128, 0.18);border-radius:8px;background:rgba(107, 114, 128, 0.025);padding:12px 16px 16px;margin:16px 0 24px}.dark .mcp-server-tabs{border-color:rgba(156, 163, 175, 0.16);background:rgba(156, 163, 175, 0.025)}.mcp-server-meta{display:flex;flex-direction:column;align-items:flex-start;gap:0.5rem;margin:0 0 1.5rem;font-size:0.875rem}.mcp-server-meta a::after{content:\"\\2197\";margin-left:0.15em}#page-title .mcp-title-logo{display:inline-block;width:0.9em;height:0.9em;margin:0 0.3em 0 0;vertical-align:-0.08em}#content:has(>.mcp-server-page){margin-top:0.75rem}.mcp-auth-summary{color:rgb(var(--primary));font-weight:600}.dark .mcp-auth-summary{color:rgb(var(--primary-light))}.mcp-auth-summary::selection,.mcp-auth-summary *::selection{background-color:rgb(var(--primary));color:#fff}.dark .mcp-auth-summary::selection,.dark .mcp-auth-summary *::selection{background-color:rgb(var(--primary-light));color:#fff}"}]}
{"page":{"pagePath":"docs/guides/core-concepts/resources/grpc","slug":"/docs/guides/core-concepts/resources/grpc","pageMetadata":{"$schema":"schemas/docs.schema.yaml","title":"gRPC","description":"How to connect to a gRPC Resource using the Formal Connector","icon":"code","href":"/docs/guides/core-concepts/resources/grpc"},"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: \"How to connect to a gRPC Resource using the Formal Connector\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`requirements`,children:`Requirements`}),`\n`,_jsx(_components.p,{children:``}),`\n`,_jsx(Heading,{level:`3`,id:`networking`,children:`Networking`}),`\n`,_jsx(_components.p,{children:`Certain ports must be accessible to connect to Formal Resources. You can listen on multiple ports simultaneously for various Resources.`}),`\n`,_jsx(_components.p,{children:`gRPC is a high-performance, open-source Remote Procedure Call (RPC) framework that uses HTTP/2 for transport, Protocol Buffers as the interface description language, and provides features like authentication, bidirectional streaming, and flow control. The Formal Connector enables you to proxy and monitor gRPC traffic to your APIs while enforcing policies and logging all interactions.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The connector runs a healthcheck server on port 8080 to let clients determine if the proxy is operational. As a result, you cannot create a listener on port 8080 to connect to a gRPC resource.`})}),`\n`,_jsx(Heading,{level:`3`,id:`resource-health-check`,children:`Resource health check`}),`\n`,_jsxs(_components.p,{children:[`Formal periodically checks that the Connector can open a TCP connection to the gRPC server. When `,_jsx(_components.a,{href:`/docs/guides/core-concepts/resources/tls`,children:`TLS`}),` is enabled for the Resource, the check also completes a TLS handshake. It does not send gRPC requests.`]}),`\n`,_jsx(Heading,{level:`3`,id:`native-users`,children:`Native Users`}),`\n`,_jsxs(_components.p,{children:[`The Connector can inject upstream credentials with Native Users. gRPC Resources accept the HTTP credential types, such as `,_jsx(_components.strong,{children:`HTTP Bearer`}),` and `,_jsx(_components.strong,{children:`API Key (Header)`}),`. Header credentials reach the server as gRPC metadata.`]}),`\n`,_jsxs(_components.p,{children:[`To send each user’s own OAuth token instead, use `,_jsx(_components.a,{href:`/docs/guides/core-concepts/resources/oauth`,children:`linked accounts`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-to-a-grpc-resource`,children:`Connect to a gRPC Resource`}),`\n`,_jsx(_components.p,{children:`To connect to a gRPC resource with a Formal identity, set the following metadata in your gRPC calls:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`x-formal-user-username`}),`: The username of the user making the request`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`x-formal-user-password`}),`: The user’s authentication credentials`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`connecting-using-the-grpc-cli`,children:`Connecting using the gRPC CLI`}),`\n`,_jsxs(_components.p,{children:[`To connect using `,_jsx(_components.code,{children:`grpc_cli`}),`, execute the following command:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`grpc_cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` call`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` CONNECTOR_HOSTNAME:PORT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GRPC_METHOD_NAME`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --metadata`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-formal-user-username:FORMAL_USERNAME:x-formal-user-password:FORMAL_ACCESS_TOKEN\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Make sure to replace `,_jsx(_components.code,{children:`CONNECTOR_HOSTNAME`}),`, `,_jsx(_components.code,{children:`PORT`}),`, `,_jsx(_components.code,{children:`GRPC_METHOD_NAME`}),`, `,_jsx(_components.code,{children:`FORMAL_USERNAME`}),`, and `,_jsx(_components.code,{children:`FORMAL_ACCESS_TOKEN`}),` with the right values.`]}),`\n`,_jsx(Heading,{level:`2`,id:`smart-routing`,children:`Smart Routing`}),`\n`,_jsx(_components.p,{children:`The Connector features Smart Routing for gRPC, allowing the linkage of an\nunlimited number of Resources over the same port.`}),`\n`,_jsx(_components.p,{children:`Prefix the Connector hostname with the resource name:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`grpc_cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` call`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` RESOURCE_NAME.CONNECTOR_HOSTNAME:PORT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GRPC_METHOD_NAME`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --metadata`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-formal-user-username:FORMAL_USERNAME:x-formal-user-password:FORMAL_ACCESS_TOKEN\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`RESOURCE_NAME`}),`, `,_jsx(_components.code,{children:`CONNECTOR_HOSTNAME`}),`, `,_jsx(_components.code,{children:`PORT`}),`, `,_jsx(_components.code,{children:`GRPC_METHOD_NAME`}),`,\n`,_jsx(_components.code,{children:`FORMAL_USERNAME`}),`, and `,_jsx(_components.code,{children:`FORMAL_ACCESS_TOKEN`}),` with the right values.`]}),`\n`,_jsxs(_components.p,{children:[`If your gRPC client dials one address and sends a separate authority or server\nname, set that value to `,_jsx(_components.code,{children:`RESOURCE_NAME.CONNECTOR_HOSTNAME`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Make sure your DNS entries are properly configured to handle the subdomain\nrouting, i.e. that `,_jsx(_components.code,{children:`*.CONNECTOR_HOSTNAME`}),` targets your Connector. Use a\nwildcard TLS certificate that covers every resource subdomain.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`policy-evaluation`,children:`Policy Evaluation`}),`\n`,_jsx(_components.p,{children:`Formal supports the following policy evaluation stages for gRPC:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Session`}),`: Evaluate and enforce policies at connection time`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Request`}),`: Evaluate and enforce policies before request execution`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`policies-and-controls`,children:`Policies and Controls`}),`\n`,_jsxs(_components.p,{children:[`You can apply Formal policies to gRPC traffic at the `,_jsx(_components.strong,{children:`session`}),` and `,_jsx(_components.strong,{children:`request`}),` stages. The gRPC method name is available as `,_jsx(_components.code,{children:`input.grpc.method_name`}),`.`]})]})}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":{"codeStyling":{"languages":{"custom":["/languages/cel.json","/languages/rego.json"]}},"config":{},"pageMetadata":{"$schema":"schemas/docs.schema.yaml","title":"gRPC","description":"How to connect to a gRPC Resource using the Formal Connector","icon":"code","href":"/docs/guides/core-concepts/resources/grpc"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Requirements","slug":"requirements","depth":2,"children":[{"title":"Networking","slug":"networking","depth":3,"children":[]},{"title":"Resource health check","slug":"resource-health-check","depth":3,"children":[]},{"title":"Native Users","slug":"native-users","depth":3,"children":[]}]},{"title":"Connect to a gRPC Resource","slug":"connect-to-a-grpc-resource","depth":2,"children":[{"title":"Connecting using the gRPC CLI","slug":"connecting-using-the-grpc-cli","depth":3,"children":[]}]},{"title":"Smart Routing","slug":"smart-routing","depth":2,"children":[]},{"title":"Policy Evaluation","slug":"policy-evaluation","depth":2,"children":[]},{"title":"Policies and Controls","slug":"policies-and-controls","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/formal/95bf6302f158143a/changelog-anchors.js","/_mintlify/custom/formal/1fc14acb665ed213/unify.js","/_mintlify/custom/formal/70b3ea987ce3606f/mcp-title-logo.js"],"subdomain":"formal","siteName":"Formal Documentation","title":"gRPC - Formal Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T22:06:17.144Z","originalFileLocation":"docs/guides/core-concepts/resources/grpc.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=\"How to connect to a gRPC Resource using the Formal Connector\">\u003cmeta data-mint-head name=\"application-name\" content=\"Formal 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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_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/formal/JTklofhU3CiKKLkr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"gRPC - Formal Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to connect to a gRPC Resource using the Formal Connector\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Formal Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://formal.mintlify.site/_mintlify/api/og/v2?division=Technologies\u0026amp;title=gRPC\u0026amp;description=How+to+connect+to+a+gRPC+Resource+using+the+Formal+Connector\u0026amp;theme=5f30324034da8ef6d4d1d60d\u0026amp;signature=27189a30ee06b4cc49c3fe6fee15213a723a7524e15e522fbea6e492a9cf6710\">\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=\"gRPC - Formal Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to connect to a gRPC Resource using the Formal Connector\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formal.mintlify.site/_mintlify/api/og/v2?division=Technologies\u0026amp;title=gRPC\u0026amp;description=How+to+connect+to+a+gRPC+Resource+using+the+Formal+Connector\u0026amp;theme=5f30324034da8ef6d4d1d60d\u0026amp;signature=27189a30ee06b4cc49c3fe6fee15213a723a7524e15e522fbea6e492a9cf6710\">\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/formal/JTklofhU3CiKKLkr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Formal Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3D6EFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/core-concepts/resources/grpc.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.formal.ai/#organization\",\"name\":\"Formal Documentation\",\"url\":\"https://docs.formal.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/formal/LPWo9xz8zdnEa7zx/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=LPWo9xz8zdnEa7zx\u0026q=85\u0026s=62917f1d8ace80d33c05e036424ba8c7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.formal.ai#website\",\"name\":\"Formal Documentation\",\"url\":\"https://docs.formal.ai\",\"publisher\":{\"@id\":\"https://docs.formal.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc#webpage\",\"url\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc\",\"name\":\"gRPC\",\"description\":\"How to connect to a gRPC Resource using the Formal Connector\",\"dateModified\":\"2026-11-04T22:06:17.144Z\",\"isPartOf\":{\"@id\":\"https://docs.formal.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuring Formal\",\"item\":\"https://docs.formal.ai/docs/guides/core-concepts/connectors/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Technologies\",\"item\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/postgres\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"gRPC\",\"item\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc#article\",\"headline\":\"gRPC\",\"name\":\"gRPC\",\"description\":\"How to connect to a gRPC Resource using the Formal Connector\",\"url\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc\",\"mainEntityOfPage\":{\"@id\":\"https://docs.formal.ai/docs/guides/core-concepts/resources/grpc#webpage\"},\"dateModified\":\"2026-11-04T22:06:17.144Z\",\"publisher\":{\"@id\":\"https://docs.formal.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.formal.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Formal Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Formal Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/guides/core-concepts/resources/grpc.md","siteName":"Formal Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Documentation","icon":"house","href":"/docs/guides/getting-started"},{"title":"What is Formal?","icon":"circle-question","href":"/docs/guides/getting-started/what-is-formal"},{"title":"Architecture","icon":"sitemap","href":"/docs/guides/getting-started/architecture"},{"title":"Quickstart","icon":"bolt","href":"/docs/guides/getting-started/quickstart"},{"title":"Set Up Formal with Recipes","icon":"book-open","sidebarTitle":"Recipes","href":"/docs/guides/getting-started/recipes"},{"title":"Formal Agent","icon":"sparkles","sidebarTitle":"Formal Agent","href":"/docs/guides/getting-started/formal-agent"}]},{"group":"Example Use Cases","pages":[{"title":"Block Agent Git Pushes","icon":"code-branch","sidebarTitle":"Block Agent Git Pushes","href":"/docs/guides/example-use-cases/block-agent-git-pushes"},{"title":"Keep API Keys Out of Cloud Agent Sandboxes","icon":"key","sidebarTitle":"Cloud Agent Credential Injection","href":"/docs/guides/example-use-cases/cloud-agent-credential-forwarding"},{"title":"Give Devin Just-in-Time Database Access","icon":"database","sidebarTitle":"Devin Database Access","href":"/docs/guides/example-use-cases/devin-database-access-oidc"},{"title":"Encrypt MCP OAuth Tokens","icon":"key","sidebarTitle":"Encrypt MCP OAuth Tokens","href":"/docs/guides/example-use-cases/encrypt-mcp-oauth-tokens"},{"title":"Prevent Cloud Agents from Auto-Merging PRs","icon":"cloud","sidebarTitle":"Block Agent Auto-Merge","href":"/docs/guides/example-use-cases/formal-endpoint-cloud-agents"},{"title":"Install Formal Endpoint on Grok Bot","icon":"robot","sidebarTitle":"Grok Bot","href":"/docs/guides/example-use-cases/formal-endpoint-grok-bot"},{"title":"Keep Stripe API Keys Off Laptops","icon":"stripe","sidebarTitle":"Keep Stripe API Keys Off Laptops","href":"/docs/guides/example-use-cases/keep-stripe-api-keys-off-laptops"},{"title":"Protect Git Tokens in Command Lines","icon":"terminal","sidebarTitle":"Protect Git Tokens in Argv","href":"/docs/guides/example-use-cases/protect-git-tokens-in-command-lines"},{"title":"Restrict Anthropic Sign-Ins to One Org","icon":"user-lock","sidebarTitle":"Restrict Anthropic Sign-Ins","href":"/docs/guides/example-use-cases/restrict-anthropic-sign-ins"},{"title":"Restrict Codex Desktop to LLM and MCP","icon":"shield-halved","sidebarTitle":"Codex Desktop Egress","href":"/docs/guides/example-use-cases/restrict-codex-desktop-egress"},{"group":"Credential Injection for Sandboxes","icon":"key","pages":[{"title":"Keep API Keys Out of Daytona Sandboxes","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/daytona.svg","sidebarTitle":"Daytona","href":"/docs/guides/example-use-cases/sandbox-credential-injection/daytona"},{"title":"Keep API Keys Out of E2B Sandboxes","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/e2b.svg","sidebarTitle":"E2B","href":"/docs/guides/example-use-cases/sandbox-credential-injection/e2b"},{"title":"Keep API Keys Out of Modal Sandboxes","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/modal.svg","sidebarTitle":"Modal","href":"/docs/guides/example-use-cases/sandbox-credential-injection/modal"}]}]},{"group":"AI Governance","pages":[{"title":"AI Governance","icon":"robot","sidebarTitle":"Overview","href":"/docs/guides/ai-governance/overview"},{"title":"Review Shadow AI","icon":"binoculars","sidebarTitle":"Shadow AI","href":"/docs/guides/ai-governance/shadow-ai"},{"title":"Set Guardrails for Unknown MCPs and Skills","icon":"lock","sidebarTitle":"Guardrails","href":"/docs/guides/ai-governance/guardrails"},{"title":"Approve Access Requests","icon":"user-check","sidebarTitle":"Access Requests","href":"/docs/guides/ai-governance/access-requests"},{"title":"Monitor AI Usage","icon":"chart-line","sidebarTitle":"AI Usage","href":"/docs/guides/ai-governance/usage"},{"title":"Control LLM Spend","icon":"dollar-sign","sidebarTitle":"LLM Spend","href":"/docs/guides/ai-governance/spend"}]},{"group":"Configuring Formal","pages":[{"group":"Connector","icon":"server","pages":[{"title":"Introduction","icon":"plug","href":"/docs/guides/core-concepts/connectors/introduction"},{"title":"Listeners and Rules","icon":"route","href":"/docs/guides/core-concepts/connectors/listeners"},{"title":"Hostname and TLS Configuration","icon":"shield","href":"/docs/guides/core-concepts/connectors/tls"},{"title":"Token Encryption","icon":"key","href":"/docs/guides/core-concepts/connectors/token_encryption"},{"title":"Deployment","icon":"rocket","href":"/docs/guides/core-concepts/connectors/deployment"},{"title":"Clustering","icon":"network-wired","href":"/docs/guides/core-concepts/connectors/clustering"},{"title":"Health","icon":"heart-pulse","href":"/docs/guides/core-concepts/connectors/health"},{"title":"Operations","icon":"gears","href":"/docs/guides/core-concepts/connectors/operations"},{"title":"FIPS","icon":"shield-check","href":"/docs/guides/core-concepts/connectors/fips"}]},{"group":"MCP Gateway","icon":"plug","pages":[{"title":"MCP Gateway","icon":"plug","href":"/docs/guides/core-concepts/connectors/mcp-gateway"},{"group":"MCP Servers","pages":[{"title":"MCP servers","icon":"plug","href":"/docs/guides/core-concepts/connectors/mcp-servers/index"},{"title":"Airtable","sidebarTitle":"Airtable","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/airtable.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/airtable"},{"title":"Amplitude","sidebarTitle":"Amplitude","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/amplitude.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/amplitude"},{"title":"Apollo.io","sidebarTitle":"Apollo.io","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/apollo.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/apollo"},{"title":"Asana","sidebarTitle":"Asana","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/asana.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/asana"},{"title":"Ashby","sidebarTitle":"Ashby","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/ashby.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/ashby"},{"title":"Atlassian","sidebarTitle":"Atlassian","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/atlassian.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/atlassian"},{"title":"Braintrust","sidebarTitle":"Braintrust","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/braintrust.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/braintrust"},{"title":"Buildkite","sidebarTitle":"Buildkite","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/buildkite.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/buildkite"},{"title":"Canva","sidebarTitle":"Canva","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/canva.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/canva"},{"title":"CircleCI","sidebarTitle":"CircleCI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/circleci.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/circleci"},{"title":"Clerk","sidebarTitle":"Clerk","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/clerk.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/clerk"},{"title":"ClickHouse","sidebarTitle":"ClickHouse","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/clickhouse.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/clickhouse"},{"title":"ClickUp","sidebarTitle":"ClickUp","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/clickup.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/clickup"},{"title":"Cloudflare","sidebarTitle":"Cloudflare","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudflare.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudflare"},{"title":"Cloudflare Logpush","sidebarTitle":"Cloudflare Logpush","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudflare.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudflare-logpush"},{"title":"Cloudflare Observability","sidebarTitle":"Cloudflare Observability","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudflare.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudflare-observability"},{"title":"Cloudflare Workers Bindings","sidebarTitle":"Cloudflare Workers Bindings","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudflare.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudflare-bindings"},{"title":"Cloudflare Workers Builds","sidebarTitle":"Cloudflare Workers Builds","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudflare.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudflare-builds"},{"title":"Cloudinary","sidebarTitle":"Cloudinary","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/cloudinary.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/cloudinary"},{"title":"Context7","sidebarTitle":"Context7","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/context7.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/context7"},{"title":"Datadog","sidebarTitle":"Datadog","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/datadog.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/datadog"},{"title":"Egnyte","sidebarTitle":"Egnyte","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/egnyte.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/egnyte"},{"title":"Exa","sidebarTitle":"Exa","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/exa.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/exa"},{"title":"Figma","sidebarTitle":"Figma","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/figma.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/figma"},{"title":"Fireflies","sidebarTitle":"Fireflies","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/fireflies.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/fireflies"},{"title":"Formal Docs MCP","sidebarTitle":"Formal Docs MCP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/formal.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/formal-docs"},{"title":"Formal MCP","sidebarTitle":"Formal MCP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/formal.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/formal"},{"title":"GitHub","sidebarTitle":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/github.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/github"},{"title":"GitLab Orbit","sidebarTitle":"GitLab Orbit","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/gitlab.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/gitlab-orbit"},{"title":"Gmail","sidebarTitle":"Gmail","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/gmail.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/gmail"},{"title":"Gong","sidebarTitle":"Gong","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/gong.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/gong"},{"title":"Google Calendar","sidebarTitle":"Google Calendar","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/google-calendar.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/google-calendar"},{"title":"Google Drive","sidebarTitle":"Google Drive","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/google-drive.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/google-drive"},{"title":"Grafana Cloud","sidebarTitle":"Grafana Cloud","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/grafana.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/grafana-cloud"},{"title":"Granola","sidebarTitle":"Granola","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/granola.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/granola"},{"title":"Heroku","sidebarTitle":"Heroku","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/heroku.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/heroku"},{"title":"Hex","sidebarTitle":"Hex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/hex.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/hex"},{"title":"Honeycomb","sidebarTitle":"Honeycomb","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/honeycomb.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/honeycomb"},{"title":"HubSpot","sidebarTitle":"HubSpot","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/hubspot.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/hubspot"},{"title":"Hugging Face","sidebarTitle":"Hugging Face","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/hugging-face.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/hugging-face"},{"title":"incident.io","sidebarTitle":"incident.io","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/incident-io.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/incident-io"},{"title":"Intercom","sidebarTitle":"Intercom","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/intercom.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/intercom"},{"title":"LaunchDarkly","sidebarTitle":"LaunchDarkly","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/launchdarkly.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/launchdarkly"},{"title":"Linear","sidebarTitle":"Linear","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/linear.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/linear"},{"title":"Lucid","sidebarTitle":"Lucid","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/lucid.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/lucid"},{"title":"Microsoft Learn","sidebarTitle":"Microsoft Learn","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/microsoft.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/microsoft-learn"},{"title":"Miro","sidebarTitle":"Miro","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/miro.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/miro"},{"title":"Mixpanel","sidebarTitle":"Mixpanel","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mixpanel.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/mixpanel"},{"title":"monday.com","sidebarTitle":"monday.com","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/monday.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/monday"},{"title":"Mux","sidebarTitle":"Mux","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mux.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/mux"},{"title":"Neon","sidebarTitle":"Neon","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/neon.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/neon"},{"title":"Netlify","sidebarTitle":"Netlify","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/netlify.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/netlify"},{"title":"Notion","sidebarTitle":"Notion","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/notion.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/notion"},{"title":"PayPal","sidebarTitle":"PayPal","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/paypal.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/paypal"},{"title":"PlanetScale","sidebarTitle":"PlanetScale","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/planetscale.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/planetscale"},{"title":"PostHog","sidebarTitle":"PostHog","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/posthog.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/posthog"},{"title":"Postman","sidebarTitle":"Postman","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/postman.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/postman"},{"title":"Prisma Postgres","sidebarTitle":"Prisma Postgres","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/prisma.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/prisma"},{"title":"PubMed","sidebarTitle":"PubMed","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/pubmed.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/pubmed"},{"title":"Pylon","sidebarTitle":"Pylon","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/pylon.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/pylon"},{"title":"Railway","sidebarTitle":"Railway","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/railway.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/railway"},{"title":"Ramp","sidebarTitle":"Ramp","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/ramp.png","href":"/docs/guides/core-concepts/connectors/mcp-servers/ramp"},{"title":"Sanity","sidebarTitle":"Sanity","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/sanity.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/sanity"},{"title":"Sentry","sidebarTitle":"Sentry","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/sentry.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/sentry"},{"title":"Slack","sidebarTitle":"Slack","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/slack/slack-mark.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/slack"},{"title":"Socket","sidebarTitle":"Socket","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/mcp/socket.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/socket"},{"title":"Square","sidebarTitle":"Square","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/square.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/square"},{"title":"Stripe","sidebarTitle":"Stripe","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/stripe.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/stripe"},{"title":"Supabase","sidebarTitle":"Supabase","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/supabase.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/supabase"},{"title":"Todoist","sidebarTitle":"Todoist","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/todoist.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/todoist"},{"title":"Vercel","sidebarTitle":"Vercel","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/vercel.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/vercel"},{"title":"Webflow","sidebarTitle":"Webflow","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/webflow.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/webflow"},{"title":"Zapier","sidebarTitle":"Zapier","icon":"https://mintlify.s3.us-west-1.amazonaws.com/formal/static/brands/zapier.svg","href":"/docs/guides/core-concepts/connectors/mcp-servers/zapier"},{"title":"Custom MCP server","sidebarTitle":"Custom MCP server","icon":"plus","href":"/docs/guides/core-concepts/connectors/mcp-servers/custom"}]}]},{"group":"Endpoint","icon":"desktop","pages":[{"title":"Formal Endpoint","icon":"desktop","sidebarTitle":"Overview","href":"/docs/guides/client-apps/desktop-app"},{"title":"Write Network Rules","icon":"filter","href":"/docs/guides/network-rules"},{"title":"Install Formal Endpoint on macOS","icon":"apple","sidebarTitle":"macOS","href":"/docs/guides/client-apps/macos"},{"title":"Install Formal Endpoint on Windows","icon":"windows","sidebarTitle":"Windows","href":"/docs/guides/client-apps/windows"},{"title":"Install Formal Endpoint on Linux","icon":"linux","sidebarTitle":"Linux","href":"/docs/guides/client-apps/linux"},{"title":"Formal Endpoint for Kubernetes","icon":"circle-nodes","sidebarTitle":"Kubernetes","href":"/docs/guides/client-apps/kubernetes-egress"},{"title":"Formal Endpoint for Amazon ECS","icon":"aws","sidebarTitle":"Amazon ECS","href":"/docs/guides/client-apps/ecs-egress"},{"title":"OIDC","icon":"id-card","href":"/docs/guides/client-apps/oidc"},{"title":"CLI Reference","icon":"terminal","href":"/docs/guides/client-apps/cli"},{"title":"Configuration","icon":"sliders","href":"/docs/guides/client-apps/configuration"}]},{"group":"Observability","icon":"chart-line","pages":[{"title":"Logs","icon":"file-lines","href":"/docs/guides/observability/logs"},{"title":"Log Schemas","icon":"pen-to-square","href":"/docs/guides/observability/log-schemas"},{"title":"Control Plane Logs","icon":"shield-halved","href":"/docs/guides/observability/control-plane-logs"},{"title":"Sessions","icon":"signal-stream","href":"/docs/guides/observability/sessions"},{"title":"Explore the Access Graph","icon":"circle-nodes","sidebarTitle":"Access Graph","href":"/docs/guides/observability/access-graph"},{"title":"Insights","icon":"lightbulb","href":"/docs/guides/observability/insights"}]},{"group":"Policies","icon":"shield-check","pages":[{"title":"Introduction","icon":"book-open","href":"/docs/guides/policies/introduction"},{"title":"Enforcement","icon":"gavel","href":"/docs/guides/policies/enforcement"},{"title":"Evaluation","icon":"microscope","href":"/docs/guides/policies/evaluation"},{"title":"Rego Built-in Functions","icon":"function","sidebarTitle":"Built-in Functions","href":"/docs/guides/policies/rego-builtins"},{"title":"Hooks","icon":"webhook","href":"/docs/guides/policies/hooks"},{"title":"Examples","icon":"code","href":"/docs/guides/policies/examples"},{"title":"Operations","icon":"wrench","href":"/docs/guides/policies/operations"},{"title":"Triggered Policies and Policy Suspensions","icon":"clock-rotate-left","sidebarTitle":"Suspensions","href":"/docs/guides/policies/suspensions"},{"title":"Policy Stage Configuration","icon":"toggle-on","sidebarTitle":"Stage Configuration","href":"/docs/guides/policies/stage-configuration"},{"title":"SQL functions","icon":"list-tree","href":"/docs/reference/sql-functions"}]},{"group":"Workflows","icon":"diagram-project","pages":[{"title":"Workflows","icon":"diagram-project","href":"/docs/guides/configuration/workflows"},{"title":"Forms","icon":"rectangle-list","href":"/docs/guides/configuration/forms"}]},{"group":"Resources","icon":"database","pages":[{"title":"Introduction","icon":"plug","href":"/docs/guides/core-concepts/resources/introduction"},{"title":"Native Users","icon":"user","href":"/docs/guides/core-concepts/resources/native-users"},{"title":"OAuth and Linked Accounts","icon":"key","href":"/docs/guides/core-concepts/resources/oauth"},{"title":"Hostname and TLS Configuration","icon":"shield","href":"/docs/guides/core-concepts/resources/tls"},{"title":"Dial Configuration","icon":"plug","href":"/docs/guides/core-concepts/resources/dial"},{"title":"Smart Routing","icon":"route","href":"/docs/guides/core-concepts/resources/smart-routing"}]},{"group":"Technologies","icon":"microchip","pages":[{"title":"Postgres","icon":"database","href":"/docs/guides/core-concepts/resources/postgres"},{"title":"MySQL","icon":"database","href":"/docs/guides/core-concepts/resources/mysql"},{"title":"MariaDB","icon":"database","href":"/docs/guides/core-concepts/resources/mariadb"},{"title":"Redshift","icon":"aws","href":"/docs/guides/core-concepts/resources/redshift"},{"title":"MongoDB","icon":"leaf","href":"/docs/guides/core-concepts/resources/mongodb"},{"title":"Snowflake","icon":"snowflake","href":"/docs/guides/core-concepts/resources/snowflake"},{"title":"BigQuery","icon":"google","href":"/docs/guides/core-concepts/resources/bigquery"},{"title":"ClickHouse","icon":"database","href":"/docs/guides/core-concepts/resources/clickhouse"},{"title":"AWS","icon":"aws","href":"/docs/guides/core-concepts/resources/aws"},{"title":"DynamoDB","icon":"aws","href":"/docs/guides/core-concepts/resources/dynamodb"},{"title":"AWS S3","icon":"aws","href":"/docs/guides/core-concepts/resources/s3"},{"title":"GCP","icon":"google","href":"/docs/guides/core-concepts/resources/gcp"},{"title":"HTTP","icon":"globe","href":"/docs/guides/core-concepts/resources/http"},{"title":"Web","icon":"browser","href":"/docs/guides/core-concepts/resources/web"},{"title":"MCP","icon":"robot","href":"/docs/guides/core-concepts/resources/mcp"},{"title":"LLM","description":"How Formal proxies LLM API traffic through the Formal Endpoint or a Connector","icon":"brain-circuit","href":"/docs/guides/core-concepts/resources/llm"},{"title":"gRPC","icon":"code","href":"/docs/guides/core-concepts/resources/grpc"},{"title":"SSH/AWS SSM","description":"Connect to SSH and AWS SSM hosts through the Formal Connector or the Formal Endpoint","icon":"terminal","href":"/docs/guides/core-concepts/resources/ssh"},{"title":"RDP","icon":"desktop","href":"/docs/guides/core-concepts/resources/rdp"},{"title":"Kubernetes","icon":"dharmachakra","href":"/docs/guides/core-concepts/resources/kubernetes"},{"title":"Redis","icon":"database","href":"/docs/guides/core-concepts/resources/redis"}]},{"title":"Assessments","icon":"brain-circuit","href":"/docs/guides/core-concepts/assessments"},{"title":"Spaces","icon":"layer-group","href":"/docs/guides/core-concepts/spaces"},{"title":"Satellites","icon":"satellite","href":"/docs/guides/core-concepts/satellites"},{"title":"Data Inventory","icon":"warehouse","href":"/docs/guides/core-concepts/data-inventory"},{"title":"Identities","icon":"users","href":"/docs/guides/core-concepts/identities"},{"title":"Permissions","icon":"shield-check","href":"/docs/guides/core-concepts/permissions"}]},{"group":"Integrations","pages":[{"group":"Cloud Accounts","icon":"cloud","pages":[{"title":"Introduction","icon":"cloud","href":"/docs/guides/integrations/clouds/introduction"},{"title":"AWS","icon":"aws","href":"/docs/guides/integrations/clouds/aws"},{"title":"GCP","icon":"google","href":"/docs/guides/integrations/clouds/gcp"},{"title":"Azure","icon":"microsoft","href":"/docs/guides/integrations/clouds/azure"}]},{"title":"Log Integration","icon":"pipe","href":"/docs/guides/integrations/log"},{"title":"Mobile Device Management","icon":"mobile","href":"/docs/guides/integrations/mdm"},{"title":"OIDC","icon":"id-card","href":"/docs/guides/integrations/oidc"},{"title":"Encryption Keys","icon":"key","href":"/docs/guides/integrations/encryption_keys"},{"title":"Business Intelligence","icon":"chart-line","href":"/docs/guides/integrations/bi"},{"title":"Single Sign-On","icon":"right-to-bracket","href":"/docs/guides/integrations/sso"},{"title":"SCIM","icon":"right-to-bracket","href":"/docs/guides/integrations/scim"},{"title":"Chat Integrations","icon":"comments","href":"/docs/guides/integrations/chats"}]},{"group":"Configuration","pages":[{"title":"Terraform","icon":"code","href":"/docs/guides/configuration/terraform"},{"title":"Pulumi","icon":"code","href":"/docs/guides/configuration/pulumi"},{"group":"Kubernetes Operator","icon":"dharmachakra","pages":[{"title":"Introduction","icon":"dharmachakra","href":"/docs/guides/core-concepts/kubernetes-operator/introduction"},{"title":"Deployment","icon":"rocket","href":"/docs/guides/core-concepts/kubernetes-operator/deployment"},{"title":"Custom Resources","icon":"cubes","href":"/docs/guides/core-concepts/kubernetes-operator/custom-resources"}]},{"title":"SDKs","icon":"code-branch","href":"/docs/guides/configuration/sdks"}]}]},{"tab":"API","pages":[{"title":"API","href":"/docs/api/introduction"}]},{"tab":"Glossary","pages":[{"title":"Glossary","href":"/docs/glossary"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/changelog"}]}]},"basePath":"","title":"gRPC - Formal Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}