{"id":4928,"date":"2026-10-07T10:53:27","date_gmt":"2026-10-07T10:53:27","guid":{"rendered":"https:\/\/help.aliteo.com\/alfa-authentication-session-creation-and-mcp-connector-management-in-profile\/"},"modified":"2026-11-08T16:54:51","modified_gmt":"2026-11-08T16:54:51","slug":"authentication-session-creation-and-mcp-connector-management-in-profile","status":"publish","type":"post","link":"https:\/\/help.aliteo.com\/en\/authentication-session-creation-and-mcp-connector-management-in-profile\/","title":{"rendered":"Authentication, Session Creation, and MCP Connector Management in Profile"},"content":{"rendered":"Connecting an AI assistant to ALITEO is conducted through authorized sessions. Users retain full control over the permissions granted to their agent and which active sessions are linked to their account.\n\n\n<h2 class=\"wp-block-heading\">Initial Sign-In and Assistant Authorization Flow<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Once the AI client initiates communication with the server address specified in the configuration, an authentication interface opens in the web browser:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n    <li><strong>Account Sign-In<\/strong> \u2013 the standard ALITEO login dialog is displayed (email and password, or SSO), identical to logging into the regular web application.<\/li>\n    <li><strong>Selecting the Agent Permission Level<\/strong> \u2013 the user determines the scope of privileges granted to the AI assistant for this connection:\n        <ul>\n            <li><strong>Read<\/strong> \u2013 the agent can only search and read data (tasks, projects, timesheets); write operations are blocked.<\/li>\n            <li><strong>Read and Write<\/strong> \u2013 the agent can create and edit tasks and timesheets; it has read-only access to projects.<\/li>\n            <li><strong>Full Management<\/strong> \u2013 the agent has full access to all operations matching standard user account permissions.<\/li>\n        <\/ul>\n    <\/li>\n    <li><strong>Naming the Session<\/strong> \u2013 enter a custom session name (e.g., <em>Cursor - Work Laptop<\/em>, <em>Claude Desktop<\/em>). This name serves to uniquely identify the assistant.<\/li>\n    <li><strong>Completing Authorization<\/strong> \u2013 upon confirmation, the link is established and the AI assistant receives access to data.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Overview of Company Availability in Profile<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">At the programmatic level, the assistant inspects company availability and user identity using the following tools:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n    <li><strong>listCompanies<\/strong> \u2013 list of companies the user has access to via the API\/MCP (only companies with a paid license where the user is an active internal member). Also returns the user's <code>userCompanyId<\/code> for that company.<\/li>\n    <li><strong>getMyUserCompany<\/strong> \u2013 quickly inspects the identity and permissions of the currently authenticated user in the context of the selected company.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Session Management in Profile<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Sessions<\/strong> section, users can see all logins of their AI assistants across all devices:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n    <li><strong>Name<\/strong> \u2013 custom session name specified during the initial assistant sign-in.<\/li>\n    <li><strong>Last Activity<\/strong> \u2013 date and exact time of the last tool call or request from the client.<\/li>\n    <li><strong>Status<\/strong> \u2013 current connection status:\n        <ul>\n            <li><em>Connected<\/em> (green) \u2013 session is active and the assistant is ready to operate.<\/li>\n            <li><em>Disconnected<\/em> \u2013 session was terminated by the user or administrator.<\/li>\n            <li><em>Expired<\/em> (orange) \u2013 authorization token expired due to inactivity.<\/li>\n        <\/ul>\n    <\/li>\n    <li><strong>Permissions<\/strong> \u2013 permission level approved by the user for this session (e.g., <em>Full Management<\/em>, <em>Read<\/em>).<\/li>\n    <li><strong>Disconnect Button (broken link icon)<\/strong> \u2013 instantly invalidates the authorization token for the given session. The assistant immediately loses access to the application.<\/li>\n    <li><strong>Refresh Button<\/strong> \u2013 reloads the current status and activity timestamps of sessions without requiring a full page refresh.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Connecting an AI assistant to ALITEO is conducted through authorized sessions. Users retain full control over the permissions granted to their agent and which active sessions are linked to their account. Initial Sign-In and Assistant Authorization Flow Once the AI client initiates communication with the server address specified in the configuration, an authentication interface opens [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[1053],"tags":[],"class_list":["post-4928","post","type-post","status-publish","format-standard","hentry","category-configuration-and-authorization-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/posts\/4928","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/comments?post=4928"}],"version-history":[{"count":1,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/posts\/4928\/revisions"}],"predecessor-version":[{"id":4955,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/posts\/4928\/revisions\/4955"}],"wp:attachment":[{"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/media?parent=4928"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/categories?post=4928"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.aliteo.com\/en\/wp-json\/wp\/v2\/tags?post=4928"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}