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 in the web browser:
- Account Sign-In – the standard ALITEO login dialog is displayed (email and password, or SSO), identical to logging into the regular web application.
- Selecting the Agent Permission Level – the user determines the scope of privileges granted to the AI assistant for this connection:
- Read – the agent can only search and read data (tasks, projects, timesheets); write operations are blocked.
- Read and Write – the agent can create and edit tasks and timesheets; it has read-only access to projects.
- Full Management – the agent has full access to all operations matching standard user account permissions.
- Naming the Session – enter a custom session name (e.g., Cursor - Work Laptop, Claude Desktop). This name serves to uniquely identify the assistant.
- Completing Authorization – upon confirmation, the link is established and the AI assistant receives access to data.
Overview of Company Availability in Profile
At the programmatic level, the assistant inspects company availability and user identity using the following tools:
- listCompanies – 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
userCompanyId for that company.
- getMyUserCompany – quickly inspects the identity and permissions of the currently authenticated user in the context of the selected company.
Session Management in Profile
In the Sessions section, users can see all logins of their AI assistants across all devices:
- Name – custom session name specified during the initial assistant sign-in.
- Last Activity – date and exact time of the last tool call or request from the client.
- Status – current connection status:
- Connected (green) – session is active and the assistant is ready to operate.
- Disconnected – session was terminated by the user or administrator.
- Expired (orange) – authorization token expired due to inactivity.
- Permissions – permission level approved by the user for this session (e.g., Full Management, Read).
- Disconnect Button (broken link icon) – instantly invalidates the authorization token for the given session. The assistant immediately loses access to the application.
- Refresh Button – reloads the current status and activity timestamps of sessions without requiring a full page refresh.