Web AI apps

These apps add Lune as a connector: ChatGPT, Claude, Grok, Perplexity, Manus, Muse, Grok Bot, and any other app with a custom connector form. ChatGPT, Claude, Grok, and Grok Bot sign you in to Lune through the browser, so there's nothing to paste. Perplexity and Manus take an access key. Muse starts with an access key and can switch to OAuth once the connector works.

If you use Claude Code, Cursor, Codex, Hermes Agent, or another agent configured with a command or a config file, follow Local AI agents.

Fill in a custom connector form

Most forms ask for three things:

Field	What to enter
Name	`Lune`
Server URL	`https://mcp.luneresearch.com` (some forms call it "MCP server URL")
Authentication	OAuth, or the form's default. Leave client ID and secret empty.

Save the form. The app opens a Lune sign-in window. Sign in, check the permissions it asks for, and click Approve.

If the form asks for an authorization URL or a token URL, copy them from Authorization server. Lune has no client secret. If the form needs a client ID before it connects, register one with the registration endpoint, using the callback URL the form shows as the redirect URI. auth.md has the request.

Use an access key instead

Use an access key when the app can't do OAuth, asks for an API key, or only lets you set a header.

On the Credentials page, open API keys and click New key. Copy the key now, because the dashboard shows it only once.

Put the key where the app asks for it. An API key field takes the key as it is. A header takes the name Authorization and the value Bearer lune_your_access_key, with your key after Bearer. A JSON config takes this shape:

{
  "mcpServers": {
    "lune": {
      "type": "http",
      "url": "https://mcp.luneresearch.com",
      "headers": { "Authorization": "Bearer lune_your_access_key" }
    }
  }
}

A key bills the team it was created in. It works until you revoke it, or until an expiry date set when it was created.

App notes

The Install page has the full steps for each app, with your access key filled in where the app needs one.

ChatGPT. Lune is in ChatGPT's plugin directory. Find it under Plugins in the sidebar, add it, and sign in to Lune when ChatGPT asks. In a new chat, type @Lune to call it directly.

Claude. Add Lune from Claude's Connectors Directory and approve the sign-in. The same listing covers Claude on the web, desktop, and mobile.

Grok. Open grok.com/connectors, or click + in the chat box and open Connectors. Click Add connector, and in the New Connector dialog choose Custom. Enter the name Lune and the server URL, click Add Connector, and approve the Lune sign-in.

Grok Bot. This is xAI's desktop agent app. Open Marketplace in the sidebar, or Settings then Plugins, whichever your version shows, and add a custom MCP server with the name Lune and the server URL. Approve the Lune sign-in in your browser. If Grok Bot asks for a header instead, use an access key. If there's no custom-server option, ask Grok Bot in a chat to add a custom MCP server called Lune at https://mcp.luneresearch.com. In a task, type @Lune to attach it.

Muse. Meta's agent builds the connector itself. In a chat, ask Muse to create a custom connector for Lune from https://luneresearch.com/docs/mcp. When it asks for a credential, paste an access key into the credential prompt Muse opens, not into the chat. Muse keeps the key in its Secure Credentials Store. Once the connector works, you can ask Muse to switch it to OAuth; the Install page has the message to send.

Perplexity. Click Customize in the sidebar, or click + in the chat box and then Manage Connectors. Click + Custom connector in the top-right corner and choose Remote. Fill in Name, a short Description, and MCP server URL, and set Transport to Streamable HTTP. Open Advanced, choose API Key under Authentication, and paste an access key. Tick the box that says you understand the risks of custom connectors, click Add, then click the Lune card under Connectors to turn it on. Perplexity also asks for an icon; the Install page recipe has one to download.

Manus. Open Settings, then Connectors, + Add Connectors, and Custom MCP. Choose Import by JSON and paste the JSON from the Install page. It carries an access key.

Other apps. Add the server URL in the app's MCP or connector settings. If the app supports OAuth, it asks you to sign in. If not, use an access key.

Common questions

Does the AI app see my password? No. You sign in on Lune's own page in your browser, and the app receives a token for your account, never the password.

Which team pays for the requests? A sign-in connection bills your personal team. An access key bills the team it was created in. Teams & access keys explains how to use a shared team's plan.

Can I revoke an app's access? Yes, on the Credentials page. With your personal team selected, the OAuth clients tab lists the apps you connected by signing in. Revoking one stops it from renewing its sign-in; the access token it already holds keeps working for up to an hour. A revoked access key stops working within five minutes.

What does Lune share with the app's maker? Only what the tool calls return: search results, paper text, citation lists, and, when you run out of requests, the usage numbers in the error message. Lune doesn't send your email address or payment details. The app's own privacy policy covers what it does with those results.

When something goes wrong

If the sign-in window keeps spinning, the app is probably blocking pop-ups. Allow them for the app's site and try again.
If the assistant connects but has no Lune tools, remove the connector and add it again. Some apps cache the tool list.
If you lose access to the AI app's account, revoke its Lune connection on the Credentials page.
Error codes and fixes are in Troubleshooting.