Connect Silverbucket to your AI client (MCP)

Connect Silverbucket to your AI client (MCP)

What is this?

Connect an AI assistant such as Claude or Microsoft 365 Copilot directly to your Silverbucket data using MCP (Model Context Protocol), an open standard. Once connected, you can ask questions about your projects, people and capacity, or have the assistant make changes for you, without switching apps or copy-pasting.
Try: "List all active projects and who leads each one", "Who has free capacity next month?", "What am I allocated to next week?"

Getting access

MCP access is not on by default. It needs to be enabled for your organisation first, so contact your Silverbucket account contact. Once it is enabled, the steps below work for you and your colleagues. Until then, connecting will not work, even if you can sign in to Silverbucket or create an API token.

Pick your client

Your AI client
How you connect
Who sets it up
Claude ( claude.ai )
Sign in with your Silverbucket login
You, about 2 minutes (on Team and Enterprise plans an Owner adds the connector first)
Microsoft 365 Copilot
Sign in with your Silverbucket login
One admin creates a shared agent (about 15 minutes); everyone else just signs in
Claude Desktop, Cursor, Windsurf
API token
You (an admin creates the token once MCP is enabled)
ChatGPT, Gemini and other MCP clients
OAuth if supported, otherwise API token
See "ChatGPT, Gemini and other clients"
Server address for every client: https://mcp.agbucket.com/mcp
We recommend the sign-in options (Claude, Copilot) where available: you sign in as yourself, the assistant only sees what you can see, and there is no long-lived secret to manage.

Before you start

  • MCP enabled for your organisation (see Getting access above).
  • Your Silverbucket address, for example yourcompany.agbucket.com.
  • Your Silverbucket login.
  • Tip: log in to Silverbucket in another browser tab first. It makes the connection step finish on its own.

Claude ( claude.ai )

Who adds the connector depends on your Claude plan: on Free, Pro and Max you add it yourself; on Team an Owner adds it once for the organisation; on Enterprise an Owner (or a custom role with "Manage access to Libraries") does.

Add the connector (you on Pro/Max, or your Owner on Team/Enterprise)

    Pro/Max: Customize → Connectors → + Add → Add custom connector. Team/Enterprise owners: Organization settings → Connectors → Add → Custom → Web.
    Name it "Silverbucket", enter https://mcp.agbucket.com/mcp and continue.
    Accept the detected authentication settings and select Add.

Connect with your own login (everyone)

    Go to Customize → Connectors, find Silverbucket and select Connect.
    Enter your Silverbucket address and continue.
    Log in to Silverbucket as usual and authorise.
    You are connected. Turn the connector on in a chat with the + button → Connectors.

Microsoft 365 Copilot

Copilot uses an agent that someone in your organisation creates once and shares. You need Copilot Studio ( copilotstudio.microsoft.com ) with permission to create and publish agents, and a Microsoft 365 Copilot licence.
Microsoft's own guide:  Connect your agent to an existing MCP server  . Menu names in Copilot Studio change from time to time, so if a screen differs from the steps below, follow Microsoft's page.

Part A: create the agent (one person, once)

    Create the agent. In Copilot Studio choose Agents → Create blank agent. Name it "Silverbucket" and add the instruction "Answer questions about resource planning using the Silverbucket tools." If "Search all websites" appears under Knowledge, remove it so answers come from Silverbucket.
    Add the Silverbucket tool. On the Build tab select + next to Tools → + Add → Model Context Protocol (MCP) and enter:
  • Server name: Silverbucket
  • Server description: Resource planning, projects, tasks, allocations and capacity in Silverbucket
  • Server URL: https://mcp.agbucket.com/mcp
  • Authentication: OAuth 2.0
  • Type: Dynamic discovery
    Sign in. Log in to Silverbucket in another tab first. Then in the connection window choose Not connected → Create new connection, enter your Silverbucket address, log in, and select Add.
    Publish. On the Build tab choose + next to Channels → Microsoft 365 and Microsoft Teams. Under Availability pick Microsoft Copilot and Microsoft Teams and save (this cannot be changed after publishing). Select Publish.
    Test. In the Preview tab ask "Do I have any allocations for today?".
    Share. Use the Share icon, add colleagues or a security group (or choose End user access under Organization for everyone), and send them the steps below.

Part B: use the agent (everyone else)

    Open the link you were given, or go to  m365.cloud.microsoft/chat  and choose Silverbucket under Agents.
    First time only: log in to Silverbucket in another tab, ask a question, accept the connection request, enter your Silverbucket address and log in.
    Ask away. Copilot only sees the Silverbucket data you can see.

Claude Desktop, Cursor and Windsurf (API token)

    Make sure MCP is enabled for your organisation (see Getting access). Then, in Silverbucket, an admin creates a token: Admin → System settings → Tokens → Create token. Copy it; it is shown once.
    Add Silverbucket to your client's MCP configuration, replacing YOUR_API_TOKEN and the instance URL.
    Restart your client and try a question.

Claude Desktop (claude_desktop_config.json) and Cursor (~/.cursor/mcp.json)

{
"mcpServers": {
"silverbucket": {
"url": "https://mcp.agbucket.com/mcp",
"headers": {
"Authorization": "Token YOUR_API_TOKEN",
"X-Silverbucket-URL": "https://your-instance.agbucket.com"
}
}
}
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

Same as above, but use serverUrl instead of url.

Technical details

For your IT or security team.
  • Server address: https://mcp.agbucket.com/mcp
  • Host and port: mcp.agbucket.com, port 443 (HTTPS only)
  • Transport: MCP over Streamable HTTP (remote MCP)
  • Sign-in (Claude, Copilot): OAuth 2.1 with PKCE and dynamic client registration. The MCP server is the authorization server and sends you to your own Silverbucket login (native, Microsoft Entra or Google SSO).
  • Token clients: Authorization: Token <token> and X-Silverbucket-URL: https://<your-address> headers on every request.
  • Where requests come from: Claude and Copilot Studio connect from Anthropic's and Microsoft's cloud services, not from the user's computer. The server must be reachable over public HTTPS, and a connection that requires a VPN will not work.
  • Network access: your network must allow outbound HTTPS to mcp.agbucket.com. This matters mainly for Claude Desktop, Cursor and Windsurf, which connect from the user's computer.
  • Data stored on the server: no Silverbucket business data. It is read and written on request and not kept. The server keeps only the sign-in session details needed to keep OAuth clients connected.
  • Permissions: the assistant acts with the signed-in user's Silverbucket permissions (or the token owner's).
  • Microsoft data policies: if your Power Platform admin restricts connectors, Copilot access to this server can be blocked by that policy.

What you can do through it

Area
Covers
Example prompt
Customers
Client companies
"List all customers with active projects"
Projects
Projects, budgets, leads, status
"Create a new project called Atlas for customer Northwind"
Tasks
Time-tracking categories within projects
"Add a 'Code Review' task to Project Atlas"
Actuals
Hours logged against tasks
"Show hours logged on Atlas last week"
Users
People, organisation node, capacity, employment dates
"List all Backend Developers in the Espoo site"
Memberships
Resource slots on projects
"Add Jane Doe to Project Nova at 50% capacity"
Allocations
Planned hours over time
"Show planned allocations for Jane Doe next month"
Capacity
Team availability by week
"What's Engineering's capacity next month?"
Organisation
Organisation hierarchy
"Show the Helsinki org structure"
Roles and competencies
Role and skill definitions, requirements
"List all competencies under the DevOps category"
User groups
Named groups of users
"Create a user group for the Helsinki office"
It can also suggest suitable candidates for an open slot on a project, for example "Who is a good fit for the open Backend Developer slot on Project Nova?". The assistant can only do what your Silverbucket permissions allow.

Important: permissions and security

  • Sign-in clients (Claude, Copilot): the assistant acts as you, with your permissions and nobody else's. Colleagues using the same Copilot agent each see their own data. Revoke access by disconnecting the connector or removing the app's access in Silverbucket.
  • Token clients: the assistant can do anything the token's owner can. Create a dedicated user with limited permissions for the integration instead of using an admin's token. Tokens do not expire; revoke one in Admin → System settings → Tokens → Delete token.
  • Changes are real: the assistant can create, update and remove data, not just read it. Some actions, such as deleting logged hours, cannot be undone. Review what the assistant plans to do before you approve it.
  • Silverbucket business data is not stored on the MCP server.

Troubleshooting

Symptom
What to do
Error mentions a policy or says something is blocked
Your organisation's Microsoft settings block it. Contact your IT team.
After logging in you end up in Silverbucket, not back in your AI client
Keep a logged-in Silverbucket tab open, return to the client and try again.
Copilot Studio Preview says "We couldn't load the chat"
Test in Microsoft 365 Copilot at  m365.cloud.microsoft/chat  instead.
Silverbucket tool not found in the agent
Check you are in the same Copilot Studio environment (top right) as when you created the agent.
Sharing asks to change how users sign in
Agent settings → Safety & access → Authenticate with Microsoft, then save, publish and share again.
Can't find the agent
Ask the creator to share it. Your IT team may need to approve it.
Asked to sign in again
Your Silverbucket sign-in expired. Sign in again.
Connection is refused or tools are unavailable
MCP may not be enabled for your organisation yet. Ask your Silverbucket account contact to enable it.
Permission errors or missing data
The assistant only sees what you can see. Ask your Silverbucket admin for access.
First reply is blank
Wait a moment and ask again.
401 Unauthorized (token clients)
Check both headers. Authorization must be Token followed by the token, and the URL must start with https://.

ChatGPT, Gemini and other clients

Any client that supports remote MCP can connect to https://mcp.agbucket.com/mcp. Use OAuth sign-in if the client supports it, otherwise the token headers above. We have not tested every third-party client. Menus, plan requirements and admin settings in these products change often, so follow the vendor's own guide for the exact steps.
  • ChatGPT: OpenAI calls these custom apps or connectors. They need Developer Mode, which is limited to certain ChatGPT plans and may need a workspace admin to turn it on. Use the server address above and OAuth authentication. Guide:  Developer mode and MCP apps in ChatGPT , and OpenAI's  MCP documentation .
  • Gemini: use Gemini Enterprise. A Google Cloud administrator adds Silverbucket as a custom MCP server data store, and the tools must be enabled after it is created. This feature may still be in preview. Guide:  Set up your custom MCP server data store . If it asks for an OAuth client ID and secret, contact your Silverbucket account contact.
  • Other clients: check the client's own MCP documentation for how to add a remote server.

FAQ

How do I get access to MCP?

Contact your Silverbucket account contact. MCP is a separate add-on and is not on by default, so it needs to be enabled for your organisation before anyone can connect.

Is this safe to connect to our production data?

Yes. The assistant uses the same permissions as the signed-in user (or the token's owner). For tokens, use a dedicated limited user.

Can we revoke access?

Yes, immediately: disconnect the connector, remove the app's access in Silverbucket, or delete the token.

Can we use this with ChatGPT or Gemini?

Possibly, if your plan and admin settings allow custom MCP servers. See "ChatGPT, Gemini and other clients" above for the vendors' guides. We have not tested every third-party client.