Skip to main content
Every client connects to the same URL:
The first time you connect, your client opens the Volteras Portal so you can sign in and approve it. See Sign in with the Volteras Portal for what happens there.
The MCP server has to be switched on for your organization before you can connect. Contact us to enable it.

​
Claude

Works in Claude on the web, Claude Desktop and the Claude mobile apps.
1

Add a custom connector

Go to Settings > Connectors and select Add custom connector. On Team and Enterprise plans, an owner adds it once under Organization settings > Connectors, and members then connect it from Settings > Connectors.
2

Enter the server details

Name it Volteras and enter https://mcp.volteras.com/mcp as the URL. Leave the advanced settings empty, then select Add.
3

Connect

Select Connect next to Volteras. Approve the request in the Volteras Portal, and you are returned to Claude.
To use it in a chat, make sure Volteras is turned on in the tools menu below the message box.

​
Claude Code

Add the server:
Add --scope user to make it available in every project, or --scope project to share it with your team through .mcp.json. Then start Claude Code, run /mcp, select volteras and choose Authenticate. Your browser opens the Volteras Portal to approve the connection.

​
VS Code

Add the server to .vscode/mcp.json in your workspace, or to your user configuration with the MCP: Open User Configuration command:
.vscode/mcp.json
Select Start above the server entry. VS Code asks you to allow the sign-in, then opens the Volteras Portal to approve it. The tools are then available to Copilot in agent mode.

​
Other clients

Any client that supports remote MCP servers over Streamable HTTP and signs in with OAuth using a Client ID Metadata Document can connect with the server URL above. Check your client’s documentation for how to add a remote server. If your client can’t sign in this way but lets you set a request header, create an MCP credential and send its access token as Authorization: Bearer <token>. Tokens last ten minutes, so this suits scripts and agents that fetch a fresh token per run better than interactive use.

​
Your own agent

For a back-end system or an agent you build yourself, use an MCP credential. That page has a working Python example.

​
Check the connection

Ask your assistant:
It calls the get_me tool and tells you the organization, the user it is acting as, and its scopes. If it only has get_me and not list_vehicles, your connection is missing the vehicles:read scope.

​
Troubleshooting

The MCP server hasn’t been switched on for your organization yet, or sign-in from AI clients hasn’t. Contact us to enable it. You may see this after approving the request in the portal.
Approval requests last ten minutes. Go back to your client and start the connection again.
Your role in the Volteras Portal doesn’t allow viewing vehicles. Ask an Owner or Admin in your organization to change your role.
Your client doesn’t identify itself with a Client ID Metadata Document, which this server requires. Use a client listed above, or an MCP credential.
Position fields need the location:read scope. When signing in, only Owners, Admins and Developers can get it, and only if it’s enabled for your organization. Contact us if it isn’t. Each vehicle’s connection must also grant telemetry access.
A vehicle’s VIN, registration plate and telemetry are only returned when its connection grants access to them. See consent-gated fields.