An Issue with Agent with Claude Opus Model cannot connect to SharePoint

Question

An Issue with Agent with Claude Opus Model cannot connect to SharePoint

Zyrka Admin 0

Hello Microsoft Support,

We are experiencing an issue with an Azure AI Foundry agent that has the SharePoint tool enabled.

Environment

Azure AI Foundry Project: pearlclaudeintegration
Agent Name: SharePointAgentTest
Tool Enabled: SharePoint (Preview)
Agent Version: 1

Issue Description The agent fails to process requests when the SharePoint tool is enabled. Even simple prompts such as:

1 do you have access to SharePoint?

result in the following error:
ErrorThe server had an error processing your request. Sorry about that! You can retry your request, or contact us through an Azure support request at: https://go.microsoft.com/fwlink/?linkid=2213926 if you keep seeing this error. (Please include the request ID e132a2bf-3b58-4087-bf7c-80bbb73f662a in your email.)

Request ID: e132a2bf-3b58-4087-bf7c-80bbb73f662a

Troubleshooting Performed

Created a new Azure AI Foundry agent.
Configured SharePoint Tool (Preview).
Tested with a basic prompt unrelated to document retrieval.
Verified the issue occurs immediately and consistently.
The agent returns a generic server error instead of a response.

Expected Behavior The agent should respond to the prompt and, when appropriate, retrieve information from the configured SharePoint source.

Actual Behavior The request fails with a server-side processing error and no additional diagnostic details are provided in the Playground.

Could you please review the request ID above and advise on the root cause? We would also appreciate any guidance regarding SharePoint tool prerequisites, permissions, tenant requirements, or known issues that may cause this behavior.

Thank you for your assistance.

SRILAKSHMI C 19,715 Reputation points Microsoft External Staff Moderator

2026-07-23T12:18:54.65+00:00
Hello @Zyrka Admin

Thank you for reaching out.

Based on the information you've provided, it appears that your Azure AI Foundry Agent fails with a generic server-side error as soon as the SharePoint (Preview) tool is enabled, even when submitting a simple prompt such as:

"Do you have access to SharePoint?"

Since the error occurs before any meaningful response is returned, this does not immediately point to a model-specific issue with Claude Opus. Instead, it may be related to the SharePoint tool configuration, authentication, licensing, tenant setup, or the Foundry Agent service.

From the available Microsoft documentation, we'd recommend verifying the following prerequisites and known requirements:

1. Verify the authentication method

The SharePoint tool requires user identity (identity passthrough). Application-only authentication (App-Only/OBO tokens) is not supported and can result in authentication failures.

2. Confirm Microsoft 365 Copilot licensing or Pay-As-You-Go (PAYG)

Both developers and end users using the SharePoint tool must have the appropriate Microsoft 365 Copilot licensing, or the tenant must have Pay-As-You-Go (PAYG) enabled for agents. Missing licensing can result in authorization failures.

3. Ensure both services are in the same Microsoft Entra tenant

The Azure AI Foundry project and the Microsoft 365/SharePoint environment should belong to the same tenant. Cross-tenant scenarios are not supported and can cause authentication failures.

4. Verify SharePoint content accessibility

Ensure that the authenticated user has read access to the SharePoint sites and documents.

Also ensure the SharePoint content has been indexed by Microsoft Search, as newly added content may take some time to become searchable.

5. Validate the agent configuration

If this is an agent tool integration issue:

Review the agent's Instructions to ensure they clearly describe when and how the SharePoint tool should be used.

If you're testing through the SDK, you can also force tool invocation using tool_choice (this option isn't available in the Playground).

To help isolate the issue, could you also confirm the following?

Does the issue occur only with Claude Opus, or do you observe the same behavior with GPT-based models (for example, GPT-4.1 or GPT-5)?

Does the SharePoint Tool show a Healthy/Connected status in the Agent configuration?

Has the SharePoint connection been successfully authenticated?

If you disable the SharePoint tool, does the agent respond normally to the same prompt?

Regarding the server error

The error message "The server had an error processing your request..."

along with the Request ID indicates a generic backend service error. Based on the available documentation, this message doesn't map to a specific documented SharePoint tool failure. However, if all the prerequisites above have been validated and the issue persists, it may require a backend investigation by the Azure AI Foundry product team using the provided Request ID.

Please refer this

SharePoint tool prerequisites & troubleshooting (REST/overall): https://learn.microsoft.com/azure/foundry/agents/how-to/tools/sharepoint?wt.mc_id=knowledgesearch_inproduct_azure-cxp-community-insider#troubleshooting

I Hope this helps. Do let me know if you have any further queries.

Thank you!

1 answer

Your answer

Answer 1

Zyrka Admin hi & thx for sharing urs issue here at Q&A portal,

The request ID is the key piece of information here. A generic 'The server had an error processing your request' indicates the failure occurred within the Azure AI Foundry service while invoking the SharePoint tool, rather than the model itself returning an error. Since the issue occurs with a newly created agent, a simple prompt, and consistently whenever the SharePoint (Preview) tool is enabled, it doesn't look like a prompt or Claude Opus issue. The fact that the same agent fails before performing any meaningful SharePoint retrieval suggests either a SharePoint tool configuration problem or a backend issue with the preview feature.

I'd verify that

The SharePoint connection is in a healthy state and has the required Microsoft Graph/SharePoint permissions.

The configured SharePoint site is accessible using the same identity.

The agent works normally when the SharePoint tool is disabled.

If the failure only occurs when the SharePoint tool is enabled, I'd open an Azure AI Foundry support case and provide the project name, agent name, request ID (e132a2bf-3b58-4087-bf7c-80bbb73f662a), region, exact UTC timestamp, and whether the issue reproduces with other models or only Claude Opus. Microsoft will need to correlate the request ID with backend telemetry to determine whether this is a known issue with the SharePoint (Preview) integration or a tenant-specific configuration problem.

rgds,

Alex

&

If my answer was helpful pls mark it and additional thx if u follow me at Q&A portal

and at my blog https://ctrlaltdel.blog/