Skip to main content

Connect Claude Code

Claude Code is Anthropic's command-line tool. It is a separate product from Claude Desktop. This page adds the SolarSENS MCP server to Claude Code from the terminal.

Before you start

  • Install Claude Code version 2.1.186 or later. Check your version:

    claude --version
  • Your administrator must enable your SolarSENS MCP access.

  • Use this server URL exactly:

    https://mcp.solarsens.co/mcp

Your SolarSENS application login and your MCP connector login are separate. The MCP does not ask you to paste a SolarSENS password into a prompt.

Add the server

Run this command from any directory:

claude mcp add --transport http solarsens https://mcp.solarsens.co/mcp

Claude Code prints Added solarsens... and saves the configuration. This step does not sign you in. Claude Code checks credentials only when it first calls the server.

A terminal running the claude mcp add command for the SolarSENS server

Complete OAuth sign-in

Start a Claude Code session in the same project, then run:

/mcp

Select solarsens and follow the prompt to open your browser. Sign in on the SolarSENS sign-in page and approve the read-only connection.

You can also start the sign-in from a shell, without opening a session:

claude mcp login solarsens

If Claude Code has no local browser to open (for example, over SSH), it prints an authorization URL instead. Open that URL on a machine with a browser, sign in, then paste the redirect URL back at the prompt.

Check the connection

claude mcp list

Before sign-in, solarsens shows ! Needs authentication. After a successful sign-in, it shows ✔ Connected. For more detail on one server, run:

claude mcp get solarsens

Test the connection

Start with discovery:

List the SolarSENS Plants I can access in Kuala Lumpur.

Then ask for a bounded read:

For the Plant you found, show yesterday's performance.
Include the date, timezone, yield, performance ratio, availability, and data
coverage.

The response should name a Plant, for example DEMO-AI-P001 for the demo account, and stay inside your account's access scope.

If the connection fails

What you seeWhat to check
claude mcp list shows ! Needs authenticationRun claude mcp login solarsens, or select solarsens from /mcp inside a session.
claude mcp list shows ✘ Failed to connectRead the failure detail with claude mcp get solarsens. Confirm the URL is https://mcp.solarsens.co/mcp.
A tool call fails with needs additional permissionsSign out and in again: claude mcp logout solarsens, then claude mcp login solarsens.
The connector connects but no Plants appearAsk your administrator to check the SolarSENS account-to-Plant mapping.
A Plant is forbiddenThe Plant is outside the signed-in account scope. This is an access result, not a prompt error.

For more failure states, see Troubleshooting.

Next steps