[{"data":1,"prerenderedAt":1565},["ShallowReactive",2],{"navigation_docs":3,"-administration-connections-mcp-connections":160,"-administration-connections-mcp-connections-surround":1560},[4,21,62,82,103,149],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Get Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-play-circle",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Gateway","i-lucide-network","\u002Fgateway","2.gateway",[27,32,37,42,47,52,57],{"title":28,"path":29,"stem":30,"icon":31},"Overview","\u002Fgateway\u002Foverview","2.gateway\u002F1.overview","i-lucide-waypoints",{"title":33,"path":34,"stem":35,"icon":36},"Models and Routing","\u002Fgateway\u002Fmodels-and-routing","2.gateway\u002F2.models-and-routing","i-lucide-brain",{"title":38,"path":39,"stem":40,"icon":41},"Smart Router","\u002Fgateway\u002Fsmart-routing","2.gateway\u002F3.smart-routing","i-lucide-route",{"title":43,"path":44,"stem":45,"icon":46},"Context Engine","\u002Fgateway\u002Fcontext-engine","2.gateway\u002F4.context-engine","i-product-context-engine",{"title":48,"path":49,"stem":50,"icon":51},"Data Integrations","\u002Fgateway\u002Fdata-integrations","2.gateway\u002F5.data-integrations","i-lucide-database",{"title":53,"path":54,"stem":55,"icon":56},"Tools","\u002Fgateway\u002Ftools","2.gateway\u002F6.tools","i-lucide-wrench",{"title":58,"path":59,"stem":60,"icon":61},"Guardrails","\u002Fgateway\u002Fguardrails","2.gateway\u002F7.guardrails","i-lucide-shield-alert",{"title":63,"icon":64,"path":65,"stem":66,"children":67,"page":20},"Compliance","i-lucide-shield-check","\u002Fcompliance","3.compliance",[68,72,77],{"title":69,"path":70,"stem":71,"icon":64},"Data Governance","\u002Fcompliance\u002Fdata-governance","3.compliance\u002F01.data-governance",{"title":73,"path":74,"stem":75,"icon":76},"Network Access","\u002Fcompliance\u002Fnetwork-access","3.compliance\u002F02.network-access","i-lucide-lock",{"title":78,"path":79,"stem":80,"icon":81},"Audit Logs","\u002Fcompliance\u002Faudit-logs","3.compliance\u002F03.audit-logs","i-lucide-scroll-text",{"title":83,"icon":84,"path":85,"stem":86,"children":87,"page":20},"Observability","i-lucide-eye","\u002Fobservability","4.observability",[88,93,98],{"title":89,"path":90,"stem":91,"icon":92},"Organization","\u002Fobservability\u002Forganization","4.observability\u002F1.organization","i-lucide-building-2",{"title":94,"path":95,"stem":96,"icon":97},"Application","\u002Fobservability\u002Fapplication","4.observability\u002F2.application","i-lucide-activity",{"title":99,"path":100,"stem":101,"icon":102},"Metrics","\u002Fobservability\u002Fmetrics","4.observability\u002F3.metrics","i-lucide-bar-chart-2",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":20},"Administration","i-lucide-settings","\u002Fadministration","5.administration",[109,114,119,129,144],{"title":110,"path":111,"stem":112,"icon":113},"Organization and Projects","\u002Fadministration\u002Forganizations-and-projects","5.administration\u002F1.organizations-and-projects","i-lucide-box",{"title":115,"path":116,"stem":117,"icon":118},"Members and Access","\u002Fadministration\u002Fmembers-and-access","5.administration\u002F2.members-and-access","i-lucide-shield-user",{"title":120,"path":121,"stem":122,"children":123,"icon":76},"Authentication","\u002Fadministration\u002Fauthentication","5.administration\u002F3.authentication",[124],{"title":125,"path":126,"stem":127,"icon":128},"Connect Model APIs","\u002Fadministration\u002Fauthentication\u002Fconnect-model-apis","5.administration\u002F3.authentication\u002F31.connect-model-apis","i-lucide-cpu",{"title":130,"path":131,"stem":132,"children":133,"icon":143},"Connections","\u002Fadministration\u002Fconnections","5.administration\u002F4.connections",[134,139],{"title":135,"path":136,"stem":137,"icon":138},"Connect MCP Servers","\u002Fadministration\u002Fconnections\u002Fmcp-connections","5.administration\u002F4.connections\u002F42.mcp-connections","i-lucide-plug",{"title":140,"path":141,"stem":142,"icon":51},"Connect Data Sources","\u002Fadministration\u002Fconnections\u002Fdata-sources-connections","5.administration\u002F4.connections\u002F43.data-sources-connections","i-lucide-link",{"title":145,"path":146,"stem":147,"icon":148},"Budgets","\u002Fadministration\u002Fbudgets","5.administration\u002F5.budgets","i-lucide-wallet",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":20},"Reference","i-lucide-book-open","\u002Freference","6.reference",[155],{"title":156,"path":157,"stem":158,"icon":159},"Using the API","\u002Freference\u002Fapi-usage","6.reference\u002F1.api-usage","i-lucide-terminal-square",{"id":161,"title":135,"body":162,"description":1553,"extension":1554,"links":1555,"meta":1556,"navigation":1557,"path":136,"seo":1558,"stem":137,"__hash__":1559},"docs\u002F5.administration\u002F4.connections\u002F42.mcp-connections.md",{"type":163,"value":164,"toc":1540},"minimark",[165,169,175,180,183,186,189,468,472,501,513,517,551,561,564,569,1357,1360,1471,1475,1519,1523],[166,167,168],"p",{},"Connect an MCP server by authorizing an identity or supplying credentials. Applications assigned to a tool setup share that identity, so prepare it with only the access the selected tools need.",[170,171,174],"who-panel",{":applies-to":172,":roles":173},"[\"Tool calls\"]","[\"Organization Admin\"]","Organization Admins connect MCP servers, select the tools each setup exposes, and choose which applications can use it.",[176,177,179],"h2",{"id":178},"how-connections-work","How connections work",[166,181,182],{},"A tool setup stores one connection and the tools selected from one server. Applications assigned to the setup share its identity. The provider still controls which resources that identity can access.",[166,184,185],{},"Selecting tools limits which operations the setup exposes; it does not narrow the resources those operations can reach. Limit permissions at the provider, then expose only the operations applications need.",[166,187,188],{},"In the table below, you can see how the different MCP providers that Optiak supports handle authentication, the identity shared by applications, the access granted, and the admin involvement required.",[190,191,197],"div",{"className":192,"role":194,"ariaLabel":195,"tabIndex":196},[193],"provider-auth-table","region","MCP provider authentication comparison",0,[198,199,200,224],"table",{},[201,202,203],"thead",{},[204,205,206,213,215,218,221],"tr",{},[207,208,209],"th",{},[210,211,212],"strong",{},"Provider",[207,214,120],{},[207,216,217],{},"Identity shared by applications",[207,219,220],{},"Access",[207,222,223],{},"Admin involvement",[225,226,227,253,276,302,325,351,374,396,418,440],"tbody",{},[204,228,229,235,244,247,250],{},[230,231,232],"td",{},[210,233,234],{},"Atlassian",[230,236,237],{},[238,239,240],"ul",{},[241,242,243],"li",{},"Rovo service-account API key",[230,245,246],{},"Atlassian service account",[230,248,249],{},"Jira and Confluence scopes plus account permissions",[230,251,252],{},"Organization admin enables API-token auth and creates the account",[204,254,255,260,267,270,273],{},[230,256,257],{},[210,258,259],{},"BigQuery",[230,261,262],{},[238,263,264],{},[241,265,266],{},"Service-account JSON key",[230,268,269],{},"Google Cloud service account",[230,271,272],{},"Query project, datasets, and jobs allowed by IAM",[230,274,275],{},"Project admin grants roles and enables the API",[204,277,278,283,293,296,299],{},[230,279,280],{},[210,281,282],{},"Databricks",[230,284,285],{},[238,286,287,290],{},[241,288,289],{},"OAuth client credentials",[241,291,292],{},"Service-principal PAT",[230,294,295],{},"Databricks service principal",[230,297,298],{},"Workspace, server, and resource permissions",[230,300,301],{},"Admin creates and assigns the principal",[204,303,304,309,316,319,322],{},[230,305,306],{},[210,307,308],{},"DeepWiki",[230,310,311],{},[238,312,313],{},[241,314,315],{},"None",[230,317,318],{},"Shared public service",[230,320,321],{},"Public GitHub repository documentation",[230,323,324],{},"Not required",[204,326,327,332,342,345,348],{},[230,328,329],{},[210,330,331],{},"Exa",[230,333,334],{},[238,335,336,339],{},[241,337,338],{},"OAuth",[241,340,341],{},"API key",[230,343,344],{},"Connected Exa team",[230,346,347],{},"Team plan, rate limits, and selected tools",[230,349,350],{},"Exa team access",[204,352,353,358,365,368,371],{},[230,354,355],{},[210,356,357],{},"GitHub",[230,359,360],{},[238,361,362],{},[241,363,364],{},"Fine-grained PAT",[230,366,367],{},"Token owner",[230,369,370],{},"Read-only tools; selected private repositories plus public repositories, subject to token permissions",[230,372,373],{},"Organization approval may be required by policy",[204,375,376,381,387,390,393],{},[230,377,378],{},[210,379,380],{},"Linear",[230,382,383],{},[238,384,385],{},[241,386,338],{},[230,388,389],{},"Linear app",[230,391,392],{},"Read-only issues, projects, and documents in the workspace",[230,394,395],{},"Workspace app approval may be required",[204,397,398,403,409,412,415],{},[230,399,400],{},[210,401,402],{},"Notion",[230,404,405],{},[238,406,407],{},[241,408,338],{},[230,410,411],{},"Authorized Notion member",[230,413,414],{},"Pages and connected sources the member can access",[230,416,417],{},"Workspace policy may require approval",[204,419,420,425,432,435,438],{},[230,421,422],{},[210,423,424],{},"Slack",[230,426,427],{},[238,428,429],{},[241,430,431],{},"User OAuth token",[230,433,434],{},"Authorizing Slack member",[230,436,437],{},"Token scopes plus member permissions",[230,439,395],{},[204,441,442,447,459,462,465],{},[230,443,444],{},[210,445,446],{},"Custom MCP server",[230,448,449],{},[238,450,451,453,456],{},[241,452,338],{},[241,454,455],{},"API key\u002Ftoken",[241,457,458],{},"No authentication",[230,460,461],{},"Identity or credential accepted by the server",[230,463,464],{},"Resources and operations allowed by the server",[230,466,467],{},"Depends on the server",[176,469,471],{"id":470},"before-you-connect","Before you connect",[238,473,474,477,480,483,498],{},[241,475,476],{},"Use an Organization Admin account to create and manage tool setups.",[241,478,479],{},"Choose an organization-owned identity where the provider supports one. Grant only the resource access and permissions the selected tools need.",[241,481,482],{},"Check whether the provider or your organization requires an administrator to approve an app, create an account, enable authentication, or issue a credential.",[241,484,485,486,489,490,493,494,497],{},"Declare the provider's confirmed processing region in ",[210,487,488],{},"Data residency",", or choose ",[210,491,492],{},"Unknown"," if you cannot confirm it. With a regional organization policy active, Optiak checks this declaration when resolving tools for each request and makes servers with a different or unknown region unavailable; changes take effect on the next request. The label is a declaration, not a guarantee of provider routing. See ",[495,496,69],"a",{"href":70},".",[241,499,500],{},"Have the provider details ready, such as the workspace or project, server URL, resource ID, API key, or OAuth secret.",[166,502,503,504,508,509,512],{},"See ",[495,505,507],{"href":506},"#supported-mcps","Supported MCPs"," for detailed instructions on how to connect to the different MCP servers supported by Optiak. Use a ",[510,511,446],"code",{}," to connect to a private MCP server or a public MCP server without a pre-integration.",[176,514,516],{"id":515},"after-you-connect","After you connect",[518,519,520,527,534,544],"ol",{},[241,521,522,523,526],{},"In the setup form, select ",[210,524,525],{},"Discover tools"," and choose only the operations this setup needs.",[241,528,529,530,533],{},"Set the setup ",[210,531,532],{},"Scope"," to the organization, selected projects, or selected applications that should be allowed to use it. Keep the setup active and save.",[241,535,536,537,540,541,543],{},"In each application, open ",[210,538,539],{},"Configuration"," → ",[210,542,53],{},", enable the assigned setup, and select the tools the application needs. An application can use only tools exposed by the setup and enabled for that application.",[241,545,546,547,497],{},"Verify the result with the application's key by following ",[495,548,550],{"href":549},"\u002Fgateway\u002Ftools#check-which-tools-an-application-can-reach","the tool access check",[166,552,553,554,558,559,497],{},"To test the tools available to an application, follow the ",[495,555,557],{"href":556},"\u002Fgetting-started\u002Fquickstart#mcp","optional MCP check in the Quickstart",". For MCP client requirements, see ",[495,560,53],{"href":54},[176,562,507],{"id":563},"supported-mcps",[565,566,568],"h3",{"id":567},"pre-integrated-mcp-servers","Pre-integrated MCP servers",[570,571,573,713,816,984,1005,1096,1187,1240,1283],"accordion",{"type":572},"multiple",[574,575,577,584,591,609,671,685,688,695],"accordion-item",{"icon":576,"label":234},"i-logos-atlassian",[166,578,579],{},[580,581],"span",{"id":582,"dataDocSection":583},"atlassian","",[166,585,586,587,590],{},"Connect Atlassian with a ",[210,588,589],{},"Rovo MCP service-account API key",". Applications assigned to this setup share that account's Jira and Confluence permissions. The connection supports read\u002Fsearch and write operations, depending on the key's scopes and the account's access. Use a service-account key for this setup; personal API tokens use a different authentication method.",[518,592,593,596,599],{},[241,594,595],{},"Have an organization administrator enable API-token authentication for Rovo MCP and create a service account.",[241,597,598],{},"Give it access to the intended Jira projects and Confluence spaces. Generate a key with only the scopes needed by your selected tools, using the table below. Use read\u002Fsearch scopes when writes aren't needed.",[241,600,601,602,605,606,497],{},"Paste the service-account API key into ",[210,603,604],{},"Bearer token"," and select ",[210,607,608],{},"Create connection",[198,610,611,624],{},[201,612,613],{},[204,614,615,618,621],{},[207,616,617],{},"Operation",[207,619,620],{},"Jira scope",[207,622,623],{},"Confluence scope",[225,625,626,641,656],{},[204,627,628,631,636],{},[230,629,630],{},"Read",[230,632,633],{},[510,634,635],{},"read:jira:agent-interface",[230,637,638],{},[510,639,640],{},"read:confluence:agent-interface",[204,642,643,646,651],{},[230,644,645],{},"Search",[230,647,648],{},[510,649,650],{},"search:jira:agent-interface",[230,652,653],{},[510,654,655],{},"search:confluence:agent-interface",[204,657,658,661,666],{},[230,659,660],{},"Create or update",[230,662,663],{},[510,664,665],{},"write:jira:agent-interface",[230,667,668],{},[510,669,670],{},"write:confluence:agent-interface",[166,672,673,674,677,678,681,682,497],{},"Jira delete and management tools require ",[510,675,676],{},"delete:jira:agent-interface"," and ",[510,679,680],{},"manage:jira:agent-interface",", respectively; those tool groups also require explicit administrator enablement. Rovo's cross-app semantic search uses ",[510,683,684],{},"search:rovo:agent-interface",[166,686,687],{},"Scopes enable operations; the service account's site, project and space permissions determine which resources those operations can access.",[166,689,690,691,694],{},"Some tools are unavailable with API keys. Tools requiring a site ",[510,692,693],{},"cloudId"," need it in their inputs. Check provider IP restrictions if requests are denied. Replace expired or revoked keys; they are not renewed automatically.",[166,696,697,700,701,707,708,497],{},[210,698,699],{},"Provider references:"," ",[495,702,706],{"href":703,"rel":704},"https:\u002F\u002Fdeveloper.atlassian.com\u002Fcloud\u002Frovo-mcp\u002Fguides\u002Fconfiguring-authentication-via-api-token\u002F",[705],"nofollow","Rovo MCP API-token authentication",", ",[495,709,712],{"href":710,"rel":711},"https:\u002F\u002Fdeveloper.atlassian.com\u002Fcloud\u002Frovo-mcp\u002Fguides\u002Fsupported-tools\u002F",[705],"supported tools and required scopes",[574,714,716,721,724,779,794,797],{"icon":715,"label":259},"i-brand-bigquery",[166,717,718],{},[580,719],{"id":720,"dataDocSection":583},"bigquery",[166,722,723],{},"Connect BigQuery with a Google Cloud service-account JSON key. Applications assigned to this setup share that account's dataset access. Queries use its IAM permissions and may incur charges in the query project.",[518,725,726,733,758,765],{},[241,727,728,729,732],{},"Select the query project in Google Cloud, enable the BigQuery API, and create a dedicated service account. Copy its ",[210,730,731],{},"Project ID"," from the Google Cloud project dashboard; use the ID, rather than the display name or project number.",[241,734,735,736,739,740,743,744,739,747,750,751,739,754,757],{},"Grant it ",[210,737,738],{},"MCP Tool User"," (",[510,741,742],{},"roles\u002Fmcp.toolUser",") and ",[210,745,746],{},"BigQuery Job User",[510,748,749],{},"roles\u002Fbigquery.jobUser",") on the query project. Grant ",[210,752,753],{},"BigQuery Data Viewer",[510,755,756],{},"roles\u002Fbigquery.dataViewer",") on only the approved datasets.",[241,759,760,761,764],{},"Create and download a ",[210,762,763],{},"JSON"," key for the account. Key creation must be permitted by your organization's Google Cloud policies.",[241,766,767,768,605,771,774,775,778],{},"Paste the JSON into ",[210,769,770],{},"Service account JSON key",[210,772,773],{},"Connect with BigQuery",". Optiak requests the BigQuery OAuth scope, ",[510,776,777],{},"https:\u002F\u002Fwww.googleapis.com\u002Fauth\u002Fbigquery","; scope alone does not grant dataset access.",[166,780,781,782,785,786,789,790,793],{},"Include the query project ID in prompts or the application's system prompt. BigQuery query tools require ",[510,783,784],{},"projectId"," for execution and billing. For example: \"Run BigQuery queries in project ",[510,787,788],{},"my-query-project",", using dataset ",[510,791,792],{},"my-data-project.sales",".\" The dataset's project may differ from the query project. The setup's name and purpose are for your team's reference and aren't passed to the model.",[166,795,796],{},"Keep dataset permissions narrow. Rotate the stored key when required; disabling the key or account interrupts the connection.",[166,798,799,700,801,707,806,707,811,497],{},[210,800,699],{},[495,802,805],{"href":803,"rel":804},"https:\u002F\u002Fdocs.cloud.google.com\u002Fbigquery\u002Fdocs\u002Fuse-bigquery-mcp",[705],"BigQuery MCP permissions",[495,807,810],{"href":808,"rel":809},"https:\u002F\u002Fdocs.cloud.google.com\u002Fbigquery\u002Fdocs\u002Freference\u002Fmcp\u002Ftools_list\u002Fexecute_sql_readonly",[705],"query tool arguments",[495,812,815],{"href":813,"rel":814},"https:\u002F\u002Fdocs.cloud.google.com\u002Fiam\u002Fdocs\u002Fkeys-create-delete",[705],"create a service-account key",[574,817,819,824,838,846,850,863,902,905,909,955,958,961,964],{"icon":818,"label":282},"i-logos-databricks-icon",[166,820,821],{},[580,822],{"id":823,"dataDocSection":583},"databricks",[166,825,826,827,830,831,833,834,837],{},"Connect Databricks as a ",[210,828,829],{},"service principal"," using ",[210,832,289],{}," or a ",[210,835,836],{},"personal access token (PAT)",". Applications allowed to use this server share that principal's workspace permissions. SQL and function tools can change data when the principal has permission.",[166,839,840,841,497],{},"Choose a managed MCP server or MCP Service in the target workspace and grant the principal access to that server and only the resources it needs. Databricks SQL requires the relevant SQL warehouse and Unity Catalog permissions; other servers require access to their Genie space, AI Search index or Unity Catalog functions. Follow the selected server's ",[495,842,845],{"href":843,"rel":844},"https:\u002F\u002Fdocs.databricks.com\u002Faws\u002Fen\u002Fagents\u002Fmcp-tools\u002Fmanaged-mcp",[705],"Databricks access requirements",[847,848,289],"h4",{"id":849},"oauth-client-credentials",[166,851,852,853,858,859,862],{},"Create a service principal assigned to the target workspace and ask a Databricks account or workspace administrator to ",[495,854,857],{"href":855,"rel":856},"https:\u002F\u002Fdocs.databricks.com\u002Faws\u002Fen\u002Fdev-tools\u002Fauth\u002Foauth-m2m",[705],"create its OAuth secret",". Keep the client ID and secret. This connection requests the ",[510,860,861],{},"all-apis"," OAuth scope; the principal's resource permissions still limit what it can access.",[166,864,865,866,868,869,872,873,876,877,880,881,884,885,888,889,876,892,677,895,898,899,497],{},"Choose ",[210,867,289],{}," in ",[210,870,871],{},"Authorization method",". The ",[210,874,875],{},"Server"," fields take the ",[210,878,879],{},"Workspace host"," without a path or query and the ",[210,882,883],{},"Server path",", such as ",[510,886,887],{},"\u002Fapi\u002F2.0\u002Fmcp\u002Fsql",". Keep any query parameters with the path. The ",[210,890,891],{},"Connection",[210,893,894],{},"Client ID",[210,896,897],{},"Client secret",". Select ",[210,900,901],{},"Connect with Databricks",[166,903,904],{},"Optiak renews access tokens automatically while the OAuth secret remains valid. Replace the secret before its expiry; automatic token renewal does not extend the secret's lifetime. Revoking the secret or removing the principal's permissions interrupts access. There is no personal OAuth consent or member sign-in.",[847,906,908],{"id":907},"personal-access-token","Personal access token",[518,910,911,918,921,937],{},[241,912,913,914,497],{},"Choose a managed MCP server or MCP Service in the target workspace. Copy its full URL, including the resource path, following the ",[495,915,917],{"href":843,"rel":916},[705],"Databricks MCP documentation",[241,919,920],{},"Create or select a dedicated service principal and assign it to that workspace. Grant access to the chosen server and only the resources it needs, such as the Genie Agent, SQL warehouse and tables, AI Search index, or Unity Catalog functions.",[241,922,923,924,927,928,933,934,497],{},"Ask a workspace administrator to confirm PAT authentication is enabled and the principal can use tokens. Have the administrator create a PAT ",[210,925,926],{},"on behalf of that service principal",", following ",[495,929,932],{"href":930,"rel":931},"https:\u002F\u002Fdocs.databricks.com\u002Faws\u002Fen\u002Fdev-tools\u002Fauth\u002Fpat#create-personal-access-tokens-for-service-principals",[705],"Create personal access tokens for service principals",". Set an explicit expiry and copy the returned ",[510,935,936],{},"token_value",[241,938,939,940,942,943,946,947,950,951,605,953,497],{},"In ",[210,941,875],{},", enter the ",[210,944,945],{},"Server URL"," from the ",[210,948,949],{},"same workspace",". Paste only the PAT value into ",[210,952,604],{},[210,954,608],{},[166,956,957],{},"PATs work with managed MCP servers and MCP Services. Servers hosted on Databricks Apps do not support this PAT connection. If the workspace restricts inbound IP addresses, it must allow requests from Optiak.",[166,959,960],{},"Optiak does not renew the PAT automatically. Replace it before expiry. Revoking it or removing the principal's permissions interrupts the affected access. A PAT is valid only for the workspace where it was issued.",[166,962,963],{},"Existing PAT connections keep their authentication method and continue to work. To switch one to OAuth client credentials, create a new Databricks server and enable it for the intended applications. Authentication methods cannot be changed after creation; remove the old connection only when it is no longer used.",[166,965,966,700,968,707,971,707,975,707,979,497],{},[210,967,699],{},[495,969,289],{"href":855,"rel":970},[705],[495,972,974],{"href":930,"rel":973},[705],"create a service principal PAT",[495,976,978],{"href":843,"rel":977},[705],"managed MCP servers",[495,980,983],{"href":981,"rel":982},"https:\u002F\u002Fdocs.databricks.com\u002Faws\u002Fen\u002Fagents\u002Fmcp-tools\u002Fconnect-clients#connect-clients-using-personal-access-token-pat-authentication",[705],"connect using a PAT",[574,985,987,992,995],{"icon":986,"label":308},"i-brand-devin",[166,988,989],{},[580,990],{"id":991,"dataDocSection":583},"deepwiki",[166,993,994],{},"Connect DeepWiki without an account or credential to explore public GitHub repository documentation. Repository names and questions are sent to DeepWiki. Private repositories are outside this connection's scope.",[166,996,997,700,1000,497],{},[210,998,999],{},"Provider reference:",[495,1001,1004],{"href":1002,"rel":1003},"https:\u002F\u002Fdocs.devin.ai\u002Fwork-with-devin\u002Fdeepwiki-mcp",[705],"DeepWiki MCP guide",[574,1006,1008,1013,1020,1033,1072,1079,1082],{"icon":1007,"label":331},"i-brand-exa",[166,1009,1010],{},[580,1011],{"id":1012,"dataDocSection":583},"exa",[166,1014,1015,1016,1019],{},"Connect Exa with an ",[210,1017,1018],{},"organization-owned Exa team"," through OAuth or an API key. Applications assigned to this server share that team's access: every search, page read and research run counts against its plan and rate limits.",[166,1021,1022,1023,1025,1026,1029,1030,1032],{},"Exa operates its services in the US. Confirm this meets your organization's requirements before connecting; set ",[210,1024,488],{}," to ",[210,1027,1028],{},"US"," if confirmed, or ",[210,1031,492],{}," if you cannot confirm it.",[518,1034,1035,1038],{},[241,1036,1037],{},"Create or choose a dedicated Exa team for this server.",[241,1039,939,1040,1042,1043],{},[210,1041,871],{},", choose how to connect that team:\n",[238,1044,1045,1055],{},[241,1046,1047,1050,1051,1054],{},[210,1048,1049],{},"OAuth 2.0:"," select ",[210,1052,1053],{},"Connect with Exa",", sign in with an account in that team and approve access.",[241,1056,1057,1060,1061,1066,1067,605,1070,497],{},[210,1058,1059],{},"API key or token:"," in the ",[495,1062,1065],{"href":1063,"rel":1064},"https:\u002F\u002Fdashboard.exa.ai\u002Fapi-keys",[705],"Exa dashboard",", create an API key dedicated to this server. Paste it into ",[210,1068,1069],{},"API key or token",[210,1071,608],{},[166,1073,1074,1075,1078],{},"Exclude ",[510,1076,1077],{},"agent_run"," unless applications need multi-step research; Exa bills each run.",[166,1080,1081],{},"Activity uses the connected team. Revoking the API key or the OAuth authorization interrupts access; to rotate the key, replace it in Optiak before revoking it in Exa.",[166,1083,1084,700,1086,707,1091,497],{},[210,1085,699],{},[495,1087,1090],{"href":1088,"rel":1089},"https:\u002F\u002Fexa.ai\u002Fdocs\u002Fget-started\u002Fexa-mcp#authentication",[705],"Exa MCP authentication and tools",[495,1092,1095],{"href":1093,"rel":1094},"https:\u002F\u002Fexa.ai\u002Fassets\u002FExa_Labs_Terms_of_Service.pdf",[705],"Exa service terms",[574,1097,1099,1104,1114,1167,1170,1173],{"icon":1098,"label":357},"i-simple-icons-github",[166,1100,1101],{},[580,1102],{"id":1103,"dataDocSection":583},"github",[166,1105,1106,1107,1110,1111,497],{},"Connect GitHub with a ",[210,1108,1109],{},"fine-grained personal access token",". Applications assigned to this setup share access limited by the token's selected resource owner, repositories and permissions, within the token owner's own access. An existing administrator can create a token restricted to selected private repositories and specific read permissions; a dedicated machine user is optional. This setup uses GitHub's ",[210,1112,1113],{},"read-only MCP endpoint",[518,1115,1116,1119,1138,1160],{},[241,1117,1118],{},"Choose a GitHub member with access to the intended repositories. You can use an existing member or administrator, or a dedicated machine user.",[241,1120,1121,1122,1125,1126,1129,1130,1133,1134,1137],{},"In that member's ",[210,1123,1124],{},"Settings → Developer settings → Personal access tokens → Fine-grained tokens",", generate a token. Select one ",[210,1127,1128],{},"Resource owner"," and an expiry date. Under ",[210,1131,1132],{},"Repository access",", choose ",[210,1135,1136],{},"Only select repositories"," and select the approved repositories.",[241,1139,1140,1141,1144,1145,707,1148,1151,1152,1155,1156,1159],{},"Under ",[210,1142,1143],{},"Repository permissions",", grant only the permissions required by the intended tools, such as ",[210,1146,1147],{},"Contents",[210,1149,1150],{},"Issues"," or ",[210,1153,1154],{},"Pull requests",", with ",[210,1157,1158],{},"Read-only"," access. Add organization or account permissions only when a selected tool requires them. Follow your organization's token policy and approval requirements.",[241,1161,1162,1163,605,1165,497],{},"Paste the token into ",[210,1164,604],{},[210,1166,608],{},[166,1168,1169],{},"Repository selection restricts private repository access; GitHub tokens also include read-only access to public repositories. The read-only endpoint limits operations, while the token's repository selection and permissions control access to private data.",[166,1171,1172],{},"Activity follows the token owner. Replace the token before expiry; revocation, account deactivation or loss of repository access interrupts access.",[166,1174,1175,700,1177,707,1182,497],{},[210,1176,699],{},[495,1178,1181],{"href":1179,"rel":1180},"https:\u002F\u002Fdocs.github.com\u002Fen\u002Fauthentication\u002Fkeeping-your-account-and-data-secure\u002Fmanaging-your-personal-access-tokens#creating-a-fine-grained-personal-access-token",[705],"create a fine-grained token",[495,1183,1186],{"href":1184,"rel":1185},"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgithub-mcp-server\u002Fblob\u002Fmain\u002Fdocs\u002Fpolicies-and-governance.md",[705],"MCP access controls",[574,1188,1190,1195,1198,1208,1223,1226],{"icon":1189,"label":380},"i-simple-icons-linear",[166,1191,1192],{},[580,1193],{"id":1194,"dataDocSection":583},"linear",[166,1196,1197],{},"Connect Linear by installing Optiak's app in the intended workspace through OAuth. Applications assigned to the setup share that app's access; each caller does not sign in with a personal Linear account.",[166,1199,1200,1201,739,1204,1207],{},"This setup currently uses Linear's ",[210,1202,1203],{},"read-only endpoint",[510,1205,1206],{},"https:\u002F\u002Fmcp.linear.app\u002Fmcp\u002Freadonly","). It can search and read issues, projects and documents, but cannot create or update them.",[518,1209,1210,1216],{},[241,1211,1212,1213,497],{},"Have a workspace administrator select ",[210,1214,1215],{},"Connect with Linear",[241,1217,1218,1219,1222],{},"In Linear, select the intended workspace and review the app's ",[210,1220,1221],{},"read access to your workspace"," before continuing. This flow has no team or resource picker; the grant is at workspace level.",[166,1224,1225],{},"Selecting tools limits the available operations; it does not restrict results to selected teams or projects. The connection uses the installed app's identity and refreshes its access token while the grant remains valid. Removing the app or revoking its grant stops access; reconnect to restore it.",[166,1227,1228,700,1230,707,1235,497],{},[210,1229,699],{},[495,1231,1234],{"href":1232,"rel":1233},"https:\u002F\u002Flinear.app\u002Fdocs\u002Fmcp",[705],"Linear MCP guide",[495,1236,1239],{"href":1237,"rel":1238},"https:\u002F\u002Flinear.app\u002Fdevelopers\u002Foauth-actor-authorization",[705],"Linear app auth",[574,1241,1243,1248,1251,1266,1269],{"icon":1242,"label":402},"i-simple-icons-notion",[166,1244,1245],{},[580,1246],{"id":1247,"dataDocSection":583},"notion",[166,1249,1250],{},"Connect Notion with a workspace member through OAuth. Applications assigned to this setup share that member's access. Tools can read and change content the member can access, including connected sources.",[518,1252,1253,1256,1263],{},[241,1254,1255],{},"Create or choose a dedicated organization-owned Notion member. Give it access only to the pages, teamspaces, and connected sources intended for this setup. A member seat may be billed by Notion.",[241,1257,1258,1259,1262],{},"Select ",[210,1260,1261],{},"Connect with Notion",". In the sign-in window, use that member's account and select the intended workspace.",[241,1264,1265],{},"Review the authorization screen and approve access. OAuth authorizes the existing member; it does not provision a separate service account.",[166,1267,1268],{},"Activity uses the authorized member's identity. Removing page access changes what the connection can reach; deactivation or revoking authorization interrupts it. To change the identity, reconnect with the intended member.",[166,1270,1271,700,1273,707,1278,497],{},[210,1272,699],{},[495,1274,1277],{"href":1275,"rel":1276},"https:\u002F\u002Fdevelopers.notion.com\u002Fguides\u002Fmcp\u002Fget-started-with-mcp",[705],"Connect to Notion MCP",[495,1279,1282],{"href":1280,"rel":1281},"https:\u002F\u002Fdevelopers.notion.com\u002Fguides\u002Fmcp\u002Fmcp-supported-tools",[705],"supported tools",[574,1284,1286,1291,1298,1342,1345,1348],{"icon":1285,"label":424},"i-logos-slack-icon",[166,1287,1288],{},[580,1289],{"id":1290,"dataDocSection":583},"slack",[166,1292,1293,1294,1297],{},"Connect Slack with a ",[210,1295,1296],{},"user OAuth token from an MCP-enabled Slack app",". Applications assigned to this setup share that token's access, limited by both its granted user-token scopes and the authorizing member's permissions. An administrator can authorize the app while keeping the token limited to public-channel reads; their admin role does not override the token's scopes. Public channels are public within the workspace.",[518,1299,1300,1303,1313,1331],{},[241,1301,1302],{},"Create an internal Slack app for this connection and choose the workspace member who will authorize it. An existing administrator can authorize it; a dedicated member is optional.",[241,1304,1305,1306,1309,1310,497],{},"In the app's ",[210,1307,1308],{},"Agents"," settings, enable ",[210,1311,1312],{},"Slack Model Context Protocol (MCP) Server",[241,1314,1140,1315,1318,1319,1322,1323,1326,1327,1330],{},[210,1316,1317],{},"OAuth & Permissions → User Token Scopes",", add only the scopes required by the intended tools. For public-channel search and reads, use ",[510,1320,1321],{},"search:read.public"," (search), ",[510,1324,1325],{},"channels:history"," (messages and threads), and ",[510,1328,1329],{},"channels:read"," (channel information and member lists). Leave private-channel, direct-message and write scopes ungranted for this configuration. Install and authorize the app as the chosen member, following workspace approval requirements.",[241,1332,1333,1334,1337,1338,605,1340,497],{},"Copy the ",[210,1335,1336],{},"user"," OAuth token, rather than the bot token. Paste it into ",[210,1339,604],{},[210,1341,608],{},[166,1343,1344],{},"Public-read scopes do not select individual public channels. To use private-channel, direct-message or write tools, add their required user-token scopes from Slack's tool reference and authorize them as Slack requires.",[166,1346,1347],{},"OAuth grants are additive: to reduce an existing token's scopes, revoke the broader grant and authorize a new token with the narrower scopes. After changes, update the stored token and rediscover tools. Optiak does not automatically rotate the pasted token. Expiry, revocation or member deactivation interrupts access.",[166,1349,1350,700,1352,497],{},[210,1351,999],{},[495,1353,1356],{"href":1354,"rel":1355},"https:\u002F\u002Fdocs.slack.dev\u002Fai\u002Fslack-mcp-server",[705],"Slack MCP overview and tool scopes",[565,1358,446],{"id":1359},"custom-mcp-server",[570,1361,1362],{"type":572},[574,1363,1364,1367,1377,1381,1396,1405,1408,1416,1419,1422,1456,1459,1462],{"icon":138,"label":446},[166,1365,1366],{},"Connect a custom MCP server using the authentication method it supports. Applications assigned to this setup share the configured identity and resource access; an unauthenticated connection sends no credentials. The server determines which tools and resources are available.",[166,1368,1369,1370,1373,1374,1376],{},"Before connecting, get the full ",[210,1371,1372],{},"public HTTPS MCP endpoint",", including its path, from the server owner. Localhost and private-network addresses are not supported. Confirm which authentication methods the server supports and what identity, resources, and permissions you should use. Then choose the supported ",[210,1375,871],{}," in the setup form.",[847,1378,1380],{"id":1379},"global-oauth","Global OAuth",[166,1382,1383,1384,1387,1388,1391,1392,1395],{},"The server must publish discoverable authorization\u002Ftoken endpoints and support ",[210,1385,1386],{},"PKCE",". Optiak uses ",[210,1389,1390],{},"Client ID Metadata Documents (CIMD)"," when supported, otherwise ",[210,1393,1394],{},"Dynamic Client Registration (DCR)"," when available. The form has no fields for a manually provisioned client ID or secret; a server requiring those cannot be configured here.",[166,1397,1398,1399,868,1402,1404],{},"Ask the server owner to confirm discovery, PKCE, and CIMD or DCR support. Select ",[210,1400,1401],{},"Connect server",[210,1403,891],{},", sign in with the intended organization-owned identity, and review the requested scopes and resources before authorizing.",[166,1406,1407],{},"OAuth authorizes an existing identity; it does not create a service account. Revocation requires reconnecting. The provider determines whether refresh is available and how long authorization remains valid.",[166,1409,1410,1411,497],{},"Reference: ",[495,1412,1415],{"href":1413,"rel":1414},"https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-11-25\u002Fbasic\u002Fauthorization",[705],"MCP authorization requirements",[847,1417,1069],{"id":1418},"api-key-or-token",[166,1420,1421],{},"Connect with a credential issued by the server owner. Its permissions and the server's access rules determine what this connection can reach.",[518,1423,1424,1427,1438,1452],{},[241,1425,1426],{},"Have the server owner issue a credential limited to the approved resources and operations. Confirm its owner, expiry and required HTTP header.",[241,1428,939,1429,1431,1432,1151,1435,497],{},[210,1430,891],{},", paste the credential and match the required header format, such as ",[510,1433,1434],{},"Authorization: Bearer \u003Ctoken>",[510,1436,1437],{},"X-API-Key: \u003Ckey>",[241,1439,1440,1441,1444,1445,1448,1449,497],{},"For ",[210,1442,1443],{},"Basic auth",", paste the Base64-encoded ",[510,1446,1447],{},"username:password"," value. For a custom header, enter its exact name and a value template containing ",[510,1450,1451],{},"{key}",[241,1453,1258,1454,497],{},[210,1455,608],{},[166,1457,1458],{},"Credentials are not renewed automatically. Replace them before expiry or after revocation, then confirm tool discovery with the replacement.",[847,1460,458],{"id":1461},"no-authentication",[166,1463,865,1464,1466,1467,1470],{},[210,1465,458],{}," only when the server accepts unauthenticated requests. Optiak sends no credentials; the server determines available resources and operations. Questions and tool inputs go to its endpoint. Continue to ",[495,1468,516],{"href":1469},"#after-you-connect"," to discover tools and assign applications.",[176,1472,1474],{"id":1473},"troubleshooting","Troubleshooting",[238,1476,1477,1486,1495,1501,1507,1513],{},[241,1478,1479,1482,1483,497],{},[210,1480,1481],{},"Authentication failed:"," reconnect the OAuth connection, or update the API key or header settings, then select ",[210,1484,1485],{},"Rediscover tools",[241,1487,1488,1151,1491,1494],{},[210,1489,1490],{},"Connection required",[210,1492,1493],{},"Connection unavailable:"," edit the setup and connect or reconnect its provider account or credential.",[241,1496,1497,1500],{},[210,1498,1499],{},"Could not reach the server:"," check that the server URL is correct and publicly reachable over HTTPS, and that its TLS certificate and firewall allow access.",[241,1502,1503,1506],{},[210,1504,1505],{},"Server timed out:"," check that the endpoint is reachable and responds within 30 seconds, then rediscover tools.",[241,1508,1509,1512],{},[210,1510,1511],{},"Server rate limit reached:"," wait a moment before rediscovering tools.",[241,1514,1515,1518],{},[210,1516,1517],{},"A tool is missing or unavailable:"," confirm that the server exposes it and the connected identity can access it. Check that the setup is active, its scope includes the application, the application enables the setup and tool, and the external connection is ready. Reconnect credentials or refresh provider access if needed.",[176,1520,1522],{"id":1521},"related","Related",[238,1524,1525,1530,1535],{},[241,1526,1527,1529],{},[495,1528,130],{"href":131},": how organization connections are shared.",[241,1531,1532,1534],{},[495,1533,53],{"href":54},": choose and use tools in an application.",[241,1536,1537,1539],{},[495,1538,115],{"href":116},": roles and access permissions.",{"title":583,"searchDepth":1541,"depth":1541,"links":1542},2,[1543,1544,1545,1546,1551,1552],{"id":178,"depth":1541,"text":179},{"id":470,"depth":1541,"text":471},{"id":515,"depth":1541,"text":516},{"id":563,"depth":1541,"text":507,"children":1547},[1548,1550],{"id":567,"depth":1549,"text":568},3,{"id":1359,"depth":1549,"text":446},{"id":1473,"depth":1541,"text":1474},{"id":1521,"depth":1541,"text":1522},"Prepare provider identities and choose which MCP tools applications can use.","md",null,{},{"icon":138},{"title":135,"description":1553},"Uiwsc_eLEClPoHXfHhCddM3u7KXlT2nyF1EEib-Z6lk",[1561,1563],{"title":130,"path":131,"stem":132,"children":-1,"description":1562,"icon":143},"Connect Optiak to external services and subscription-backed models.",{"title":140,"path":141,"stem":142,"description":1564,"icon":51,"children":-1},"Manage source access and file uploads for organization Data Integrations.",1795006123472]