Microsoft Teams connector - Writer AI Studio

Set up the Microsoft Teams connector

Configure the Microsoft Teams connector in AI Studio under Connectors & Tools. The Microsoft Teams connector supports two authentication options:

• WRITER-managed OAuth (recommended): Writer provides the OAuth application. No setup required - just authorize access to your Microsoft Teams.
• Organization-managed OAuth: Create your own Microsoft OAuth application for custom branding and control.

Most users should choose WRITER-managed OAuth for faster setup. Only use organization-managed OAuth if you need custom branding or have specific security requirements.

Create a Microsoft OAuth application (organization-managed only)

If you choose to create a self-managed OAuth application to connect, first create a new Microsoft OAuth application in Microsoft Entra ID (Azure AD):

1. Navigate to the Microsoft Entra admin center

2. Go to Applications > App registrations

3. Create a new registration

4. Configure authentication with Web platform

5. Add the Writer redirect URI to Redirect URIs:

   https://app.writer.com/mcp/oauth/callback
   

   If your organization is deployed in the EU, use https://app.eu2.writer.com/mcp/oauth/callback instead.

6. Add API permissions for the required Microsoft Graph scopes

7. Create a client secret in Certificates & secrets

8. Copy the application (client) ID and client secret

For detailed instructions, see Microsoft’s OAuth 2.0 documentation.

Required OAuth scopes

• User.Read - Read user profile information
• Team.ReadBasic.All - Read basic team information
• Channel.ReadBasic.All - Read basic channel information
• ChannelMessage.ReadWrite - Read and write channel messages
• ChannelMessage.Read.All - Read all channel messages
• ChannelMessage.Send - Send messages to channels
• ChannelSettings.ReadWrite.All - Read and write channel settings
• Chat.Create - Create chats
• Chat.ReadBasic - Read basic chat information
• Chat.Read - Read chat messages
• Chat.ReadWrite - Read and write chat messages
• Chat.ReadWrite.All - Read and write all chat messages
• ChatMessage.Read - Read chat messages
• ChatMessage.Send - Send chat messages
• ChatMember.ReadWrite - Manage chat members
• Group.Read.All - Read all groups
• Group.ReadWrite.All - Read and write all groups
• TeamMember.ReadWrite.All - Manage team members
• offline_access - Maintain access to data

Configure the connector in AI Studio

1. Navigate to Connectors & Tools in AI Studio
2. Select the Microsoft Teams connector
3. Select who has access by default (all users or specific teams)
4. Select the connection type:
   • Level: User level (each user authenticates their own account) or org level (shared connection to a single account)
   • Managed by: WRITER-managed or self-managed (your own OAuth app)
5. Select which tools to enable for your agents
6. Enter your OAuth client ID and client secret (if using self-managed OAuth)
7. Complete the OAuth authorization flow

Next steps

• Set up connectors: Learn how to configure and enable connectors in AI Studio
• Tool calling guide: Understand how AI agents use tools in conversations
• WRITER Agent guide: Learn how to use WRITER Agent with connected tools
• MCP gateway overview: Learn about Writer’s MCP gateway architecture