Set up your AI agent

Copy the prompt, paste it into your AI chat, and approve access. Your agent handles the connection.

Copy, paste, approve#

  1. Click Copy connection prompt.
  2. Paste it into Claude, Cowork, Claude Code, or another AI agent and send it.
  3. Open the approval link your agent gives you. Sign in, choose your project, and approve access. Approving needs the owner or administrator role in your organization. Finish any account or billing steps shown there.

Your agent checks the connection and available credits, then you're ready to ask it to do work. You do not need to find an API key or install anything. The agent needs command execution with network access to complete this flow.

Paste into your AI chat
I'm setting up Blackpearl in this session. Connect me now using
https://engine.neraperla.com and keep onboarding short and focused.

I authorize you to check for a working Blackpearl key, request one through
Blackpearl's browser approval flow if needed, and save it privately for this
session. I will approve the account and project in the browser. A temporary
workspace is fine; do not ask me to connect a folder.

Read https://engine.neraperla.com/docs/raw/agent-setup.md and carry out that procedure.
Use its API-key approval and polling flow. Start immediately without asking
what to do with this prompt, proposing a plan for approval, or offering other
setup methods. Reuse a working key or pending request if one already exists.
Show me the approval link as soon as you have it and keep polling while I
approve. Never display the key or ask me to paste one.

Creating the key and checking access do not consume credits. Keep setup to
those checks; do not start paid work or install or update skills, plugins,
connectors, or standing instructions. Respect the host's required permissions.
If a required tool or network request is unavailable, explain that specific
blocker briefly; do not claim to be connected.

When verified, briefly confirm the connected project and available credits.
Then continue any task I've already requested, or ask what I'd like to do.

What to expect#

Your agent sends an approval link, waits while you approve, and confirms the connection. Creating a key and checking access do not consume credits. Paid work is charged to your organization's balance and counts against the chosen project's limits when you request it.

A temporary workspace works for this session. A fresh session may need approval again. If a key is already available, your agent reuses it. You can revoke access from API keys in the Blackpearl console.

If the agent cannot read the setup guide, paste the connection instructions into the same chat.

For an explicitly chosen connector or saved skill, see Optional agent integrations.