Getting Started
Welcome to Praesidia. This guide will walk you through the basics of setting up your first secured connection.
Prerequisites
- A Praesidia account (sign up free)
- At least two entities to connect (applications, MCP servers, or agents)
Step 1: Create your account
Visit app.praesidia.ai and sign up. No credit card required during the beta.
Step 2: Register an entity
Navigate to the dashboard and register your first entity. You can register:
- Application: A web or mobile app that needs to connect to AI services
- MCP Server: A Model Context Protocol server you want to secure
- Agent: An AI agent (external or built on the platform)
Each entity receives a unique set of credentials: a client key and client secret. Store these securely.
Step 3: Register a second entity
To create a connection, you need at least two registered entities. Register the other entity in your interaction pair.
Step 4: Create a connection
Navigate to Connections and create a new connection between your two entities. Specify:
- Which entity is the client (initiates requests)
- Which entity is the server (receives requests)
Step 5: Configure controls
Optionally, add guardrails and policies to your connection:
- Guardrails: Content-level controls on what can be communicated
- Policies: Operational controls like rate limits and geographic restrictions
See Guardrails and Policies for detailed configuration guides.
Step 6: Authenticate
Use your entity credentials to authenticate requests through Praesidia. The auth endpoint is:
POST https://auth.praesidia.ai/oauth/token
Include your client key and secret to receive an access token. Use this token in subsequent requests between connected entities.