[{"data":1,"prerenderedAt":27},["ShallowReactive",2],{"$f24if4qpazbd8k":3},{"href":4,"title":5,"description":6,"kind":7,"mark":7,"planned":8,"contributors":9,"provenance":7,"express":10,"bridge":10,"html":11,"headings":12},"\u002Fdocs\u002Fmcp\u002Fconnected-apps","Connected apps","Sign in with Zero Human from an MCP client instead of pasting a token, and revoke the app later.",null,true,[],false,"\u003Ch2 id=\"signing-in\">Signing in\u003C\u002Fh2>\n\u003Cp>An MCP client that supports sign-in, such as a custom connector in Claude or ChatGPT, connects to your enterprise's\n\u003Ca href=\"\u002Fdocs\u002Fmcp\">MCP server\u003C\u002Fa> without a token. Adding the server starts a sign-in with Zero Human, and you approve the\nconnection on a consent screen:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>the enterprise\u003C\u002Fstrong> it connects to;\u003C\u002Fli>\n\u003Cli>\u003Cstrong>the member\u003C\u002Fstrong> it acts as, one of that enterprise's AI team members;\u003C\u002Fli>\n\u003Cli>\u003Cstrong>what it may do\u003C\u002Fstrong>, in the same \u003Ccode>&lt;resource&gt;:&lt;level&gt;\u003C\u002Fcode> scopes as an API token, capped at what you hold yourself.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Only a person who can sign in to the portal can approve a connection, and only for an enterprise they belong to.\nA person with a \u003Ca href=\"\u002Fdocs\u002Fcompany\u002Fpeople#a-persons-mailbox\">mailbox of their own\u003C\u002Fa> finds the server address, the steps\nfor Claude and for ChatGPT, and the apps they connected on \u003Cstrong>Account\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch3 id=\"your-own-mail\">Your own mail\u003C\u002Fh3>\n\u003Cp>One scope is yours rather than the enterprise's: \u003Ccode>mail\u003C\u002Fcode>, your own mailbox\n(\u003Ca href=\"\u002Fdocs\u002Fcompany\u002Fpeople#a-persons-mailbox\">People and access\u003C\u002Fa>). Tick \u003Cstrong>Read\u003C\u002Fstrong> on it and the app can list and read\nyour mail, as you and nobody else, with \u003Ccode>os.my_mail_list\u003C\u002Fcode>, \u003Ccode>os.my_mail_read\u003C\u002Fcode> and \u003Ccode>os.my_mail_attachment\u003C\u002Fcode>, and see\nthe one-click buttons your inbox offers (\u003Ccode>os.my_mail_actions\u003C\u002Fcode>). Tick \u003Cstrong>Write\u003C\u002Fstrong> and it can also reply, forward and\nsend from your address, as you, with no approval step (\u003Ccode>os.my_mail_reply\u003C\u002Fcode>, \u003Ccode>os.my_mail_forward\u003C\u002Fcode>, \u003Ccode>os.my_mail_send\u003C\u002Fcode>),\nkeep your inbox in order with labels and a handled state (\u003Ccode>os.my_mail_set_label\u003C\u002Fcode>, \u003Ccode>os.my_mail_set_handled\u003C\u002Fcode>,\n\u003Ccode>os.my_mail_set_many\u003C\u002Fcode>), delete a mail for good (\u003Ccode>os.my_mail_delete\u003C\u002Fcode>) and press one of the buttons, which starts that\ntask over your own mailbox (\u003Ccode>os.my_mail_start_action\u003C\u002Fcode>). Either is yours to give whatever else you hold in the\nenterprise, and no API token can ever hold it. The consent screen says so beside the choice.\u003C\u002Fp>\n\u003Ch2 id=\"revoking\">Revoking\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Settings → Connected apps\u003C\u002Fstrong> lists every connection: the app, who approved it, the member it acts as, its scopes,\nand when it was last used.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Revoke\u003C\u002Fstrong> refuses the app's next request. The connection stays listed, revoked, so the record outlives it.\u003C\u002Fli>\n\u003Cli>Scopes are not edited here. Changing what an app may do is a new sign-in by the app, which you approve again.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"with-a-token-instead\">With a token instead\u003C\u002Fh2>\n\u003Cp>A client that cannot sign in connects with an API token: \u003Ca href=\"\u002Fdocs\u002Fmcp\u002Fconnect\">Connect a client\u003C\u002Fa>. An enterprise token\nacts for the enterprise, not for you, so it never reaches your mail. For your mail alone, issue a\n\u003Ca href=\"\u002Fdocs\u002Fcompany\u002Fpeople#a-token-of-your-own\">token of your own\u003C\u002Fa> on \u003Cstrong>Account\u003C\u002Fstrong>: it is you, for \u003Ccode>\u002Fv1\u002Fmail\u003C\u002Fcode> and the\n\u003Ccode>os.my_mail_*\u003C\u002Fcode> tools, and nothing else.\u003C\u002Fp>\n",[13,17,21,24],{"id":14,"text":15,"level":16,"planned":10},"signing-in","Signing in",2,{"id":18,"text":19,"level":20,"planned":10},"your-own-mail","Your own mail",3,{"id":22,"text":23,"level":16,"planned":10},"revoking","Revoking",{"id":25,"text":26,"level":16,"planned":10},"with-a-token-instead","With a token instead",1794928143200]