Connectez des assistants IA à APIBASE avec le serveur MCP APIBASE. Les agents peuvent découvrir les schémas, interroger des lignes, lire des cellules exactes, créer des enregistrements et mettre à jour des coordonnées précises avec des requêtes Hive autorisées.
Connect AI assistants to APIBASE through the APIBASE MCP server. Agents can discover schemas, query rows, read exact cells, create records and update precise coordinates through authorized Hive requests.
MCP signifie Model Context Protocol. Il permet à une application IA de se connecter à des systèmes externes avec des outils, des ressources et des prompts contrôlés.
MCP stands for Model Context Protocol. It allows an AI application to connect to external systems through controlled tools, resources and prompts.
Le serveur MCP APIBASE agit comme un pont contrôlé entre les agents IA et les endpoints Hive d’APIBASE. Il ne donne pas au modèle un accès direct à la base de données. Il expose des outils qui appellent APIBASE par HTTP et retournent seulement les données nécessaires à la tâche.
The APIBASE MCP server acts as a controlled bridge between AI agents and APIBASE Hive endpoints. It does not give the model direct database access. It exposes tools that call APIBASE through HTTP requests and return only the data required for the task.
// Recommended architecture / Architecture recommandée
AI assistant / Assistant IA
↓ MCP client / Client MCP
APIBASE MCP server / Serveur MCP APIBASE
↓ authorized HTTP requests / requêtes HTTP autorisées
APIBASE Hive
↓
user BASE / BASE utilisateur
Les intégrations MCP sont généralement construites autour de trois primitives. APIBASE s’y rattache naturellement.
MCP integrations are usually built around three primitives. APIBASE maps naturally to them.
Actions que l’IA peut demander : lire un enregistrement, interroger des lignes, mettre à jour une cellule exacte.
Actions the AI can request. Example: read a record, query rows, update one exact cell.
Contexte contrôlé que l’IA peut consulter : schéma de table, champs autorisés, opérations disponibles.
Controlled context the AI can inspect. Example: table schema, allowed fields, available operations.
Workflows réutilisables qui guident l’IA : résumer un client ou vérifier un risque de stock.
Reusable workflows that guide the AI. Example: summarize a customer or check stock risk.
// APIBASE interpretation / Interprétation APIBASE
MCP tool → controlled APIBASE operation / opération APIBASE contrôlée
MCP resource → schema or safe context / schéma ou contexte sûr
MCP prompt → reusable AI workflow / workflow IA réutilisable
Le serveur MCP APIBASE expose un petit ensemble d’outils génériques. Ces outils correspondent directement aux opérations Hive et gardent l’IA derrière les tokens bearer, les ACL Hive et les coordonnées TLC.
The APIBASE MCP server exposes a small set of generic tools. These tools map directly to Hive operations and keep the AI behind bearer tokens, Hive ACLs and TLC coordinates.
// APIBASE MCP tools / Outils MCP APIBASE
apibase_schema → discover T and C ids / découvrir T et C
apibase_query → query rows with an operator / interroger des lignes avec un opérateur
apibase_get_cell → read one exact cell / lire une cellule exacte
apibase_get_record → read one full record / lire un enregistrement complet
apibase_post → insert one record / insérer un enregistrement
apibase_put_cell → update one exact cell / modifier une cellule exacte
apibase_put_line → update one full line / modifier une ligne complète
apibase_delete → delete one record / supprimer un enregistrement
apibase_schema, apibase_query,
apibase_get_cell and apibase_get_record.
apibase_put_cell, apibase_put_line,
apibase_post and apibase_delete.
apibase_put_cell avant d’autoriser les lignes complètes ou les suppressions.
Write tools should be enabled carefully. For AI agents, prefer exact cell updates with apibase_put_cell before allowing full-line updates or deletes.
Les outils MCP doivent décrire et accéder aux structures APIBASE avec des noms valides.
Les tables sont au pluriel. Les clés primaires utilisent id_*. Les clés étrangères utilisent *_id.
Les champs métier n’utilisent pas de soulignés.
MCP tools should describe and access APIBASE structures using valid APIBASE names.
Tables are plural. Primary keys use id_*. Foreign keys use *_id.
Business fields do not use underscores.
// Valid APIBASE structures for AI tools / Structures APIBASE valides pour outils IA
customers
C1 = id_customer
C2 = customer
C3 = email
C4 = phone
C5 = ai.note
C6 = reviewed.at
orders
C1 = id_order
C2 = order
C3 = customer_id
C4 = order.status
C5 = total.amount
stocks
C1 = id_stock
C2 = stock
C3 = product_id
C4 = stock.quantity
C5 = stock.minimum
customers, orders, products, stocks.
id_customer, customer_id, id_product, product_id.
customer_name, aiGeneratedText, ai.review.note.
ai.note, reviewed.at, order.status et stock.quantity.
Use one-level dot notation for composed business fields such as ai.note, reviewed.at, order.status and stock.quantity.
Le serveur MCP peut exposer la découverte de schéma avec apibase_schema.
Utilisez cet outil d’abord pour résoudre les ids de table et de colonne avant de lire ou d’écrire.
The MCP server can expose schema discovery through apibase_schema.
Use this first to resolve table ids and column ids before reading or writing data.
// ── PHASE 1 : discover table and column coordinates / découvrir les coordonnées table-colonne ──────────
apibase_schema(
base="acme",
table="customers"
)
// Example result / Résultat exemple
[
'T' => 2,
'columns' => [
'1' => 'id_customer',
'2' => 'customer',
'3' => 'email',
'4' => 'phone',
'5' => 'ai.note',
'6' => 'reviewed.at',
],
]
// Store these constants in the MCP server configuration / Stocker ces constantes
$T_customers = 2;
$C_customer = 2;
$C_email = 3;
$C_phone = 4;
$C_ai_note = 5;
$C_reviewed_at = 6;
Utilisez apibase_query quand l’IA doit trouver des enregistrements qui correspondent à une condition.
L’outil parcourt une table avec une colonne, un opérateur et une valeur.
Use apibase_query when the AI needs to find records matching a condition.
The tool scans a table using a column, an operator and a value.
// Find customers whose name contains "acme" / Trouver les clients dont le nom contient "acme"
apibase_query(
base="acme",
T=2,
C=2,
operator=28,
value="acme"
)
// Common APIBASE operators / Opérateurs APIBASE courants
1 = equals
3 = not equals
6 = less than
7 = greater than
8 = less than or equal
9 = greater than or equal
28 = contains
32 = between
33 = in list
Utilisez apibase_get_record lorsque l’IA a besoin d’un enregistrement complet autorisé.
Le paramètre id est la valeur primaire logique utilisée dans L{id}.
Use apibase_get_record when the AI needs one full authorized record.
The id parameter is the logical primary value used in L{id}.
// Read customer 14 from the acme base / Lire le client 14 de la base acme
apibase_get_record(
base="acme",
T=2,
id=14
)
// This maps to Hive GET / Correspond à Hive GET
GET /hive/get/acme/T2/L14?format=assoc
// Example returned data / Données retournées
[
'id_customer' => 14,
'customer' => 'Acme Industries',
'email' => 'billing@acme.example',
'phone' => '+1-555-0100',
'ai.note' => '',
'reviewed.at' => '',
]
Utilisez apibase_get_cell lorsque l’IA n’a besoin que d’une seule valeur.
C’est un accès direct par coordonnées : table, id logique et colonne.
Use apibase_get_cell when the AI only needs one value.
This is direct coordinate access: table, logical id and column.
// Read the email of customer 14 / Lire le courriel du client 14
apibase_get_cell(
base="acme",
T=2,
id=14,
C=3
)
GET /hive/get/acme/T2/L14/C3?format=raw
// Example result / Résultat exemple
"billing@acme.example"
Utilisez apibase_post pour insérer un nouvel enregistrement.
L’argument record doit être une chaîne JSON contenant des noms de champs APIBASE valides.
Use apibase_post to insert a new record.
The record argument must be a JSON string containing APIBASE-valid field names.
// Create a new customer through the MCP server / Créer un client avec le serveur MCP
apibase_post(
base="acme",
T=2,
record='{
"customer": "Acme Industries",
"email": "billing@acme.example",
"phone": "+1-555-0100",
"ai.note": "",
"reviewed.at": ""
}'
)
POST /hive/post/acme/T2
{
"record": {
"customer": "Acme Industries",
"email": "billing@acme.example",
"phone": "+1-555-0100",
"ai.note": "",
"reviewed.at": ""
}
}
add sur la table cible. Sans la bonne ACL Hive, APIBASE retourne 403.
The token must have the add right on the target table. Without the correct Hive ACL, APIBASE returns 403.
C’est le modèle d’écriture recommandé pour les agents IA. L’outil cible une coordonnée et envoie une seule valeur.
This is the preferred write pattern for AI agents. The tool targets one coordinate and sends one value.
// Update ai.note for customer 14 / Mettre à jour ai.note pour le client 14
apibase_put_cell(
base="acme",
T=2,
id=14,
C=5,
value="Customer needs follow-up this week."
)
PUT /hive/put/acme/T2/L14/C5
{
"value": "Customer needs follow-up this week."
}
// Example response / Réponse exemple
[
'status' => 'success',
'mode' => 'cell',
'message' => 'Cell updated.',
'hive_base' => 'acme',
]
Utilisez apibase_put_line seulement lorsque l’outil envoie intentionnellement un objet record.
Si une seule valeur change, utilisez plutôt apibase_put_cell.
Use apibase_put_line only when the tool intentionally sends a record object.
If only one value changes, use apibase_put_cell instead.
// Replace or update customer 14 with a record object / Remplacer ou modifier le client 14
apibase_put_line(
base="acme",
T=2,
id=14,
record='{
"customer": "Acme Industries",
"email": "billing@acme.example",
"phone": "+1-555-0100",
"ai.note": "Customer needs follow-up this week.",
"reviewed.at": "2026-05-10T14:30"
}'
)
PUT /hive/put/acme/T2/L14
{
"record": {
"customer": "Acme Industries",
"email": "billing@acme.example",
"phone": "+1-555-0100",
"ai.note": "Customer needs follow-up this week.",
"reviewed.at": "2026-05-10T14:30"
}
}
apibase_delete supprime un enregistrement par valeur primaire logique.
Il exige le droit de suppression ACL sur la table cible.
apibase_delete deletes a record by logical primary value.
It requires delete ACL on the target table.
// Delete customer 14 / Supprimer le client 14
apibase_delete(
base="acme",
T=2,
id=14
)
DELETE /hive/delete/acme/T2/L14
Une ressource peut décrire ce que l’IA est autorisée à voir et à faire. N’exposez pas le contenu brut complet de la base de données comme ressource.
A resource can describe what the AI is allowed to see and do. Do not expose raw full database content as a resource.
// Example safe MCP resource / Ressource MCP sûre
[
'uri' => 'apibase://acme/schema/customers',
'name' => 'Customers schema',
'description' => 'Safe schema for customer-related AI tools.',
'fields' => [
'id_customer',
'customer',
'email',
'phone',
'ai.note',
'reviewed.at',
],
'allowedTools' => [
'apibase_schema',
'apibase_get_record',
'apibase_get_cell',
'apibase_put_cell',
],
]
Les prompts peuvent guider l’IA vers des workflows sûrs. Ils ne remplacent pas les permissions. Ils décrivent simplement comment l’IA devrait utiliser les outils disponibles.
Prompts can guide the AI toward safe workflows. They do not replace permissions. They simply describe how the AI should use the available tools.
// Example MCP prompt: customer summary / Prompt MCP : résumé client
[
'name' => 'summarize.customer',
'description' => 'Read one customer and generate a short operational summary.',
'arguments' => [
'id' => 'Customer logical primary identifier.',
],
'workflow' => [
'Call apibase_schema for customers if coordinates are unknown.',
'Call apibase_get_record with the requested id.',
'Summarize only the returned fields.',
'Do not infer hidden data.',
],
]
Le serveur MCP APIBASE est conçu autour des endpoints Hive. Cela le rend adapté aux accès contrôlés à des bases partagées avec des base keys et des ACL Hive.
The APIBASE MCP server is designed around Hive endpoints. This makes it suitable for controlled access to shared bases through base keys and Hive ACLs.
// MCP tool call / Appel d’outil MCP
apibase_get_cell(
base="acme",
T=2,
id=14,
C=3
)
GET /hive/get/acme/T2/L14/C3?format=raw
acme. L’accès est contrôlé par le token bearer et les ACL Hive au niveau des tables.
Hive uses a base key in the URL, such as acme. Access is controlled by the bearer token and table-level Hive ACLs.
Un token MCP devrait recevoir seulement les droits requis par les outils exposés. Ne donnez pas un accès large à un agent IA lorsqu’une coordonnée ciblée suffit.
An MCP token should only receive the rights required by the exposed tools. Do not give an AI agent broad access when a narrow coordinate is enough.
// Example MCP token rights for the acme base / Droits exemple
token: ai-agent
scope: hive
customers:
read: yes
add: no
edit: yes
delete: no
orders:
read: yes
add: no
edit: yes
delete: no
stocks:
read: yes
add: no
edit: no
delete: no
Le serveur MCP APIBASE devrait conserver le bearer token APIBASE. Le modèle IA ne devrait jamais voir le token, le secret brut ou des chemins de base de données non restreints.
The APIBASE MCP server should hold the APIBASE bearer token. The AI model should never see the token, the raw secret, or unrestricted database paths.
// Safe boundary / Frontière sûre
AI model / Modèle IA
↓ asks for tool call / demande un appel d’outil
APIBASE MCP server / Serveur MCP APIBASE
↓ validates arguments / valide les arguments
APIBASE Hive
↓ returns authorized result / retourne le résultat autorisé
APIBASE MCP server / Serveur MCP APIBASE
↓ filters response if needed / filtre la réponse au besoin
AI model / Modèle IA
L’outil reçoit id et retourne un résumé client filtré.
Tool receives id and returns a filtered customer summary.
Le modèle reçoit un bearer token et un accès arbitraire aux URLs APIBASE.
Model receives a bearer token and arbitrary APIBASE URL access.
Voici la première version la plus propre pour connecter des agents IA à APIBASE : outils étroits, permissions cadrées et réponses contrôlées.
This is the cleanest first version for connecting AI agents to APIBASE: tools are narrow, permissions are scoped, and responses are controlled.
// ── COMPLETE FLOW : AI agent → APIBASE MCP server → Hive ─────
// 1. User asks the AI a business question / L’utilisateur pose une question d’affaires
$question = 'What is the email for customer 14?';
// 2. AI chooses a safe MCP tool / L’IA choisit un outil MCP sûr
$tool = 'apibase_get_cell';
// 3. MCP server validates arguments / Le serveur MCP valide les arguments
$base = 'acme';
$T = 2;
$id = 14;
$C = 3;
// 4. MCP server calls APIBASE through Hive / Appel Hive
$result = apibase_get_cell(
base=$base,
T=$T,
id=$id,
C=$C
);
// 5. MCP server returns the controlled result / Retour contrôlé
return $result;
La première intégration MCP la plus sûre est en lecture seule. Ajoutez les outils d’écriture seulement lorsque les règles de validation, les ACLs et les journaux d’audit sont clairs.
The safest first MCP integration is read-only. Add write tools only when validation rules, ACLs and audit logs are clear.
// Best first version / Meilleure première version
AI agent → MCP read tools → APIBASE Hive
// Later, when controlled / Plus tard, lorsque contrôlé
AI agent → MCP write tools → exact APIBASE coordinates
Laissez les agents récupérer de l’information précise avant d’autoriser les mises à jour.
Let agents retrieve precise information before allowing updates.
Lorsque l’écriture est activée, modifiez des cellules exactes comme T2/L14/C5, pas des enregistrements larges.
When writes are enabled, update exact cells such as T2/L14/C5, not broad records.