There are two options for setting up the Microsoft Copilot MCP: Simple and Advanced. Simple should work for most customers. Use Advanced if you have specific configuration needs dependent upon your company's existing Copilot configuration.
Simple Guide
- Allow popups for Studio in your browser
- Select Agents - Tools - Add a tool
-
Enter the following:
- Name
- Description
- Server: https://mcp.recordedfuture.com/mcp
-
Select OAuth 2.0 - Dynamic Discovery
- Click create and follow the wizard. You need to login to Recorded Future with a valid account, so prepare by logging in to the portal first.
Advanced Guide
Navigate to this screen after starting the process to add a new MCP server in Copilot Studio:
Fill in the blanks with the following:
| Server URL | https://mcp.recordedfuture.com/mcp |
| Authentication | ◉ OAuth 2.0 |
| Type | ◉ Manual |
| Client ID | !SEE NOTES BELOW! |
| Client secret | Enter your original RF-provided Client Secret (server will ultimately ignore it, but can’t be blank) |
| Authorization URL | https://id.recordedfuture.com/authorize |
| Token URL template | https://id.recordedfuture.com/token |
| Refresh URL | https://id.recordedfuture.com/token |
| Scopes | openid email profile offline_access |
CLIENT ID Steps
For most customers, this step isn't yet possible. Client ID / Secret will be available as part of the General Availability release of Recorded Future MCP.
- Reference the Client ID you created in the RF Portal (assuming you created a dedicated integration API client ID/secret for this MCP Server) while going through the initial setup
- Once you see the “Your tool was created successfully!” page, you will see a Redirect URL. SAVE THIS/COPY THIS OFF. Do not attempt to establish a connection, it won’t work
-
Before you attempt to establish the connection, follow these steps:
- Run the following curl command from terminal to register your client, ensure you copy and paste the Redirect URL (in-between the quotation marks) that you received when originally adding the MCP Server in Copilot Studio, and also rename your client_name:
curl -s -X POST https://mcp.recordedfuture.com/mcp/register_client \
-H "Content-Type: application/json" \
-d '{
"client_name": "YOURCOMPANYNAMEHERE - Copilot Studio",
"redirect_uris": ["INSERTREDIRECTURLHERE"],
"grant_types": ["authorization_code", "refresh_token"],
"response_types": ["code"],
"token_endpoint_auth_method": "none",
"scope": "openid email profile offline_access"
}' | jq .
-
You will see a response come back with a different client_id
- SAVE THIS/COPY THIS OFF
-
Your will need to update the MCP server configuration with this new client_id
- In Copilot Studio, select Settings (gear icon) in the left navigation
-
Look for Custom connectors or MCP servers
- or
-
Navigate to https://make.powerapps.com
-
Ensure you're in the correct environment (same one as your agent/MCP newly created MCP server)
In the left nav, expand More → select Connections or Custom connectors
-
Ensure you're in the correct environment (same one as your agent/MCP newly created MCP server)
- Update the client ID and save the configuration
- Establish the connection and add it as a tool to whatever agent